hoziron-cli providers

Manage LLM providers registered with the daemon — list, register a custom provider, and enable/disable.

Synopsis

hoziron-cli providers <subcommand> [options]

Subcommands

SubcommandDescription
listList registered providers and their auth status
create <id>Register a custom provider with the running daemon
disable <id>Disable a registered provider
enable <id>Enable a previously-disabled provider

This is a distinct top-level command from hoziron-cli modelsmodels browses model IDs and aliases; providers manages the provider registrations those models resolve against. See models.md.


hoziron-cli providers list

hoziron-cli providers list [--json]

Examples

$ hoziron-cli providers list
PROVIDER             STATUS          MODELS
anthropic            ✓ configured    2
openai               ✓ configured    2
groq                 ✓ configured    3
ollama                ○ no key needed 1

# No providers registered yet
$ hoziron-cli providers list
No providers configured. Run: hoziron-cli providers create <id>

$ hoziron-cli providers list --json
{
  "providers": [
    {
      "id": "anthropic",
      "display_name": "Anthropic",
      "auth_status": "Configured",
      "model_count": 2
    }
  ]
}

STATUS maps from auth_status: Configured✓ configured, Missing✗ missing key, NotRequired○ no key needed.


hoziron-cli providers create

Register a custom provider with the running daemon — for internal proxies, self-hosted OpenAI-compatible endpoints, or any provider not already in config.toml.

hoziron-cli providers create <id> [--display-name <name>] [--api-key-env <var>] \
    [--base-url <url>] [--key-required] [--json]

Flags

FlagDescriptionDefault
--display-name <name>Human-readable display name
--api-key-env <var>Environment variable holding the API key (e.g. MY_PROVIDER_API_KEY)
--base-url <url>Base URL for the provider's API
--key-requiredWhether an API key is required for this provideroff
--jsonJSON output

Examples

$ hoziron-cli providers create internal-proxy \
    --display-name "Internal LLM Proxy" \
    --base-url "http://vllm.internal:8000/v1" \
    --api-key-env VLLM_API_KEY \
    --key-required
Provider 'internal-proxy' registered successfully.

# No key required (e.g. an unauthenticated local Ollama-compatible endpoint)
$ hoziron-cli providers create my-ollama --base-url "http://localhost:11434"
Provider 'my-ollama' registered successfully.

A newly registered provider has no models until they're added — check hoziron-cli models list --provider <id> after registration, and update config.toml or the daemon's model inventory as needed.


hoziron-cli providers disable / enable

Toggle a provider without removing its registration.

$ hoziron-cli providers disable internal-proxy
Provider 'internal-proxy' disabled.

$ hoziron-cli providers enable internal-proxy
Provider 'internal-proxy' enabled.

A disabled provider's models are excluded from routing and from hoziron-cli models list until re-enabled.

See Also

  • models.md — Browsing models and aliases
  • config.md — Static provider configuration in config.toml
  • vault.md — Storing provider API keys