Providers & BYOK

Pytxo ships a multi-provider registry for bring-your-own-key (BYOK) runs. Use direct provider APIs, a single OpenRouter key, local Ollama / LM Studio, or custom OpenAI-compatible endpoints — without storing secrets in pytxo.toml or Desktop.

Check configured providers

pytxo providers              # registry + whether each API key env is set (boolean only)
pytxo providers --json       # includes base URLs when known

Desktop: Settings → Providers shows the same status (never key values).

Fast path: OpenRouter

One key unlocks hundreds of models for generic OpenAI-compat CLIs:

export OPENROUTER_API_KEY=sk-or-...
pytxo models search claude --provider openrouter

Environment variables

For Azure, set both the key and AZURE_OPENAI_ENDPOINT (resource root or full .../openai/v1 URL).

Ultra managed mode strips registered BYOK keys from child environments.

Custom providers (~/.pytxo/providers.json)

Add OpenAI-compatible endpoints without waiting for a Pytxo release:

{
  "providers": [
    {
      "id": "my-proxy",
      "display_name": "My proxy",
      "api_key_env": "MY_PROXY_API_KEY",
      "openai_base_url": "https://llm.example.com/v1",
      "models_url": "https://llm.example.com/v1/models",
      "openai_compatible": true
    }
  ]
}

Then route an agent with provider = "my-proxy" and cli_adapter = "generic".

pytxo.toml agent routing

[[agent]]
name = "builder"
model = "deepseek-chat"
provider = "deepseek"
cli_adapter = "generic"
api_key_env = "DEEPSEEK_API_KEY"   # optional override

OpenRouter gateway:

[[agent]]
name = "router"
model = "anthropic/claude-3.5-sonnet"
provider = "openrouter"
cli_adapter = "generic"

Native agent CLIs (Claude Code, Antigravity, etc.) keep their own env contracts; generic --cmd shells benefit most from OpenAI-compat injection.

See also: Models CLI, pytxo.toml.