Models

Choosing and switching models across supported providers.

bash
synapse model

Opens the model picker: choose a provider and model without code changes or lock-in. Mid-conversation, use /model [provider:model] — the switch takes effect on your next message and the conversation continues seamlessly.

Supported providers

The repository bundles 35+ provider profiles as plugins, including: OpenRouter, OpenAI, Anthropic, Gemini, DeepSeek, Ollama Cloud, AWS Bedrock, Azure Foundry, Vertex AI, xAI, GitHub Copilot, HuggingFace, Fireworks, Together-class endpoints via custom profiles, and a generic custom endpoint.

ProviderGood for
OpenRouterOne key, hundreds of models — easiest start
OpenAIGPT models with first-class tool calling
AnthropicClaude models, strong long-context work
GeminiHuge context windows, multimodal input
DeepSeekCost-effective reasoning
Ollama CloudOpen-weight models without local hardware
customAny OpenAI-compatible base URL you control

Choosing a model

  • Daily driver — a mid-tier model with solid tool calling keeps costs sane for routine work
  • Heavy reasoning — swap to a stronger model with /model for architecture or debugging sessions, then switch back
  • Cheap background jobs — point cron and subagent workloads at an economical model; they do not need your best one

Model health checks

synapse doctor includes health checks for API-key provider profiles, so you can verify a model is reachable before relying on it. If a provider starts failing mid-day, run doctor first — it is usually a key or quota issue.