Connect a model provider

Wire up Anthropic, Gemini, Claude Agent SDK, a local model via Ollama, OpenAI's Codex CLI, or Cursor: your first connection so you can actually run a workflow.

Cerevisor doesn't ship its own model. You connect it to a provider you already have access to. Six kinds are supported, and you can have any number of each (except the singletons noted below). If this is your first launch, the Provider Setup modal opens automatically. If you skipped it, open it any time from the title bar menu or via Settings → Providers → + Add provider . This page walks through the simplest setup for each provider type. For the deeper guide, including managing multiple providers, per-agent overrides, and library administration, see Guides → Providers . The six provider types Type What it is When to use it Anthropic Direct API connection to Claude (Opus, Sonnet, Haiku). Cerevisor owns the agent loop. You have an Anthropic API key and want the most capable hosted models with full Cerevisor control over the loop. Singleton: one entry. Gemini Direct API connection to Google's Gemini (2.5 / 3.x families). Cerevisor owns the agent loop. You have a Google AI Studio API key and want Gemini's long-context Pro models or its cheap Flash workhorses. Singleton. See the Gemini provider page for the dedicated walkthrough. Claude Agent SDK Anthropic's official Claude Agent SDK runtime running in-process. Delegated loop (Cerevisor sets policy, the SDK runs the loop). You want Claude Code-style agent execution (read/write/edit/bash/glob/grep tools out of the box) without leaving Cerevisor. Singleton. See the Claude Agent SDK page . OpenAI-compatible Any endpoint that speaks the OpenAI Chat Completions API. Includes Ollama, OpenRouter, Together, Groq, Fireworks, vLLM, LM Studio, and OpenAI itself. You want local models (Ollama), routing across providers (OpenRouter), or anything OpenAI-API-shaped. Multiple entries allowed. OpenAI Codex CLI Sidecar to OpenAI's official codex command-line tool. Delegated loop. You have a ChatGPT subscription (Plus/Pro) and want to use Codex's quota rather than paying per token. Singleton. Cursor Agent In-process Cursor SDK runtime. Delegated loop. You have a Cursor subscription and want Cursor's agent (with its tool catalog and optional cloud execution). Singleton. Setting up Anthropic You'll need an API key from console.anthropic.com . In Provider Setup, click Anthropic . Paste your API key. Click Test connection . Cerevisor calls Anthropic's /v1/models endpoint to confirm the key works and to populate the model list. Click Save . The key is stored in your operating system's keychain, never in plain text on disk. Setting up Ollama (local models) You'll need Ollama installed and at least one model pulled ( ollama pull llama3.1 , for example). In Provider Setup, click OpenAI-compatible . Base URL: http://localhost:11434/v1 API key: leave blank, or enter any non-empty string: Ollama doesn't check. Click Test connection . Pick a default model from the dropdown. Click Save . You can repeat this with different base URLs to add OpenRouter, Groq, Together, or any other OpenAI-shaped endpoint as separate library entries. S

Back to docs