How to point Reasonix at your own OpenAI endpoint

Reasonix is hard-coded to talk to a provider endpoint, not to a model name. Adding a new endpoint is a [[providers]] entry in ~/.reasonix/config.toml and a matching API key in ~/.reasonix/.env. The same shape works for local llama.cpp, Ollama, vLLM, and remote gateways.

Common endpoints

The configuration

Two files: TOML for non-secret configuration, .env for key values. Resolution order is flag > ./reasonix.toml > ~/.reasonix/config.toml > built-in defaults.

# ~/.reasonix/config.toml
default_model = "local-coder"

[[providers]]
name        = "local-coder"
kind        = "openai"
base_url    = "http://127.0.0.1:11434/v1"          # Ollama default
models      = ["qwen2.5-coder:14b", "deepseek-coder-v2:16b"]
default     = "qwen2.5-coder:14b"
api_key_env = "OLLAMA_API_KEY"
# extra_body is merged into every chat-completions request body
extra_body  = { num_ctx = 32768 }

[[providers]]
name        = "openrouter"
kind        = "openai"
base_url    = "https://openrouter.ai/api/v1"
models      = ["openai/gpt-4o-mini", "anthropic/claude-3.5-sonnet"]
default     = "openai/gpt-4o-mini"
api_key_env = "OPENROUTER_API_KEY"

# ~/.reasonix/.env
OLLAMA_API_KEY=ollama
OPENROUTER_API_KEY=sk-or-v1-...

# pick the provider/model at launch
reasonix --model local-coder/qwen2.5-coder:14b
reasonix run "explain this file" --model openrouter/anthropic/claude-3.5-sonnet

Provider knobs worth knowing

Common failure modes

• base_url must end in /v1 for OpenAI-compatible servers. Ollama, lm-studio and vLLM all default to /v1; gateways vary. Forgetting this gives 404 on chat/completions.
• API key value goes in ~/.reasonix/.env, not in config.toml. api_key_env is the variable name, not the key.
• Local servers do not validate the key, but Reasonix still requires a non-empty value in .env. Use OLLAMA_API_KEY=ollama rather than leaving it blank.
• extra_body cannot replace model. If your endpoint expects the model id in a non-standard field, use a server-side rewrite or a vendor-specific chat_url shim.
• Switching providers mid-session rebuilds the controller but preserves history. Switching work_mode rebuilds; switching tool_approval does not.

Sources

• Configuration paths
• Reasonix example config
• CLI reference
• Guide