Providers

Configure Providers

Hexi provider selection is driven by:

  • [model] for active provider/model
  • [providers.<name>] for adapter-specific settings
  • env vars (preferred) or .hexi/local.toml for secrets

Optional package installs

OpenRouter HTTP adapter:

pip install -e ".[openrouter-http]"

OpenRouter SDK adapter:

pip install -e ".[openrouter-sdk]"

Both OpenRouter adapters:

pip install -e ".[openrouter]"

OpenRouter HTTP

[model]
provider = "openrouter_http"
model = "openai/gpt-4o-mini"

[providers.openrouter_http]
base_url = "https://openrouter.ai/api/v1"
api_style = "openai"

api_style may be openai or anthropic.

OpenRouter SDK

[model]
provider = "openrouter_sdk"
model = "openai/gpt-4o-mini"

OpenAI-compatible

[model]
provider = "openai_compat"
model = "gpt-4o-mini"

[providers.openai_compat]
base_url = "https://api.openai.com/v1"

Anthropic-compatible

[model]
provider = "anthropic_compat"
model = "claude-3-5-sonnet-latest"

[providers.anthropic_compat]
base_url = "https://api.anthropic.com"

Validate provider setup

hexi doctor
hexi doctor --probe-model