LLM Providers Quickstart
Wunderland supports 9 LLM providers out of the box. Set an API key and you are ready to go.
Provider Matrix
| Provider | Env Var | Default Model | Streaming | Tools | Vision | Cost |
|---|---|---|---|---|---|---|
| OpenAI | OPENAI_API_KEY | gpt-4o | Yes | Yes | Yes | $$$ |
| Anthropic | ANTHROPIC_API_KEY | claude-sonnet-4-20250514 | Yes | Yes | Yes | $$$ |
| Gemini | GEMINI_API_KEY | gemini-2.5-flash | Yes | Yes | Yes | $$ |
| Groq | GROQ_API_KEY | llama-3.3-70b | Yes | Yes | No | $ |
| Together | TOGETHER_API_KEY | Llama 3.3 70B | Yes | Yes | No | $ |
| Mistral | MISTRAL_API_KEY | mistral-large | Yes | Yes | No | $$ |
| xAI | XAI_API_KEY | grok-2 | Yes | Yes | Yes | $$ |
| OpenRouter | OPENROUTER_API_KEY | gpt-4o | Yes | Yes | Varies | Varies |
| Ollama | OLLAMA_BASE_URL | llama3.2 | Yes | Partial | Varies | Free |
Quick Setup
Option 1: Interactive Wizard
wunderland setup
The wizard walks you through provider selection, model choice, and key entry.
Option 2: Environment Variables
# Set one key and go
export OPENAI_API_KEY=sk-...
wunderland chat
Option 3: Config Commands
wunderland config set llmProvider anthropic
wunderland config set llmModel claude-sonnet-4-20250514
Auto-Detection
When no provider is explicitly configured, Wunderland checks for API keys in this order and uses the first one found:
OPENAI_API_KEYANTHROPIC_API_KEYGEMINI_API_KEYGROQ_API_KEYTOGETHER_API_KEYMISTRAL_API_KEYXAI_API_KEYOPENROUTER_API_KEYOLLAMA_BASE_URL
Override with --provider <name> on any CLI command.
Fallback
Set OPENROUTER_API_KEY alongside your primary key to get automatic fallback.
If the primary provider fails (rate limit, timeout), OpenRouter retries with
200+ available models.
# Primary: Anthropic. Fallback: OpenRouter (automatic)
export ANTHROPIC_API_KEY=sk-ant-...
export OPENROUTER_API_KEY=sk-or-...
OAuth (ChatGPT Subscription)
Use your ChatGPT Plus/Pro subscription instead of an API key:
wunderland login # Opens browser for device code auth
wunderland chat --oauth
Ollama (Local, Free, Private)
# Auto-detect hardware and pull recommended models
wunderland ollama-setup
# Or manually
ollama pull llama3.2
wunderland config set llmProvider ollama
Per-Agent Override
Individual agents can use different providers via agent.config.json:
{
"llmProvider": "anthropic",
"llmModel": "claude-sonnet-4-20250514"
}
Help
wunderland help llm # Detailed provider guide
wunderland help providers # Same thing (alias)
wunderland models # List available models for your configured provider
wunderland doctor # Verify API key connectivity