Docs/Getting Started

Providers & API keys

Connect Claude, Grok, Gemini, OpenAI, Azure, or a local Ollama model — and which ones can search the web.

Sprig runs on an AI model you provide. Open Settings → Provider, pick a provider, and paste in an API key (or point Chervil at a local model). Your key is stored on your machine and used only to talk to that provider.

Supported providers

Provider Web search Notes
Claude (Anthropic) āœ… Full experience — web search, Deep Dive, Verify, image reading, PDFs.
Grok (xAI) āœ… Grounds in live web + X search.
Gemini (Google) āœ… Grounds via Google Search.
OpenAI āœ… Grounds via web search.
Azure (AI Foundry / OpenAI) āž– Compose-only — no built-in web search on this endpoint.
Ollama (local) āž– Runs models on your own machine, free and private; no web access.

"Web search" means Sprig can pull in current information — news, prices, scores, weather — and cite its sources. On providers without it, Sprig answers from the model's own knowledge and will tell you when something needs live data it can't reach.

Getting a key

Each provider issues its own key from its developer console. Paste it into Settings → Provider for the matching provider. Chervil validates the key and lists the models available to you so you can pick one.

Local models with Ollama

Prefer to keep everything on your machine? Install Ollama, pull a model, and choose Ollama as your provider. It's free and private — great for everyday composing — though it can't search the web or read PDFs.

Switching providers

You can change providers anytime in Settings. Some features (live web search, Deep Dive, Verify, image and PDF attachments) light up only on providers that support them — Chervil nudges you to switch when you reach for one that your current provider can't do.