Skip to main content

Pick a provider

Anton works with any of these provider options. You choose one during onboarding (the first time you run anton), and you can switch at any time with /llm in chat or by running anton setup. All keys are persisted to ~/.anton/.env, so they carry across sessions and workspaces.

At a glance​

OptionDefault modelWeb search / fetchBest for
MindsHub — recommendedResolved from the live catalogue (sonnet / haiku tier defaults)Native passthrough, zero setupBest overall experience
Anthropic (bring your own key)claude-sonnet-4-6Native server toolsAnthropic accounts
OpenAI (bring your own key)gpt-5.4Native via Responses APIOpenAI accounts
Google Gemini (bring your own key)gemini-3-flash-previewNeeds anton setup-searchGemini accounts
Custom OpenAI-compatibleYou chooseNeeds anton setup-searchOllama, vLLM, Together, Groq, LM Studio, Azure, …

MindsHub is the default and recommended choice. During setup Anton resolves the planning and coding models from the server's live model catalogue, picking the chat models your key is actually entitled to use (embedding and decision models such as Jev are skipped), and validates the connection with a real request against that configuration:

  • Latest frontier models
  • Faster responses
  • Cost optimized
  • Secure data connectors
  • Native web search and fetch passthrough — no extra setup

During onboarding, if you don't have a MindsHub API key yet, Anton opens the signup page for you — it takes a few seconds.

The MindsHub host itself is not prompted for. To point Anton at a non-default host (staging, self-hosted), set ANTON_MINDS_URL in your environment or in ~/.anton/.env before running setup — setup honors it.

Option 2 — Bring your own key​

Choosing "Bring your own key" presents four sub-options. In each case Anton validates the key with a quick probe call before saving it.

Anthropic​

Enter your Anthropic API key and a model (default: claude-sonnet-4-6). Web search and web fetch run as Anthropic native server tools, billed on your Anthropic key — no extra setup.

OpenAI​

Enter your OpenAI API key and a model (default: gpt-5.4). Web search runs natively through the OpenAI Responses API; fetching is covered by the same capability.

Google Gemini​

Anton talks to Gemini through Google's OpenAI-compatible endpoint. Get a key at aistudio.google.com/apikey; the default model is gemini-3-flash-preview. Because this is a generic OpenAI-compatible endpoint, web search needs an external provider — run anton setup-search to configure Exa.ai or Brave Search.

Custom OpenAI-compatible endpoint​

Works with Ollama, vLLM, Together, Groq, LM Studio, Azure, or any OpenAI-compatible API. You provide:

  • Base URL — e.g. http://localhost:11434/v1 for Ollama
  • API key — press Enter to skip if your endpoint doesn't need one
  • Model name
  • API version — leave blank for standard endpoints; required for Azure

After setup, Anton offers to configure a web search provider (Exa.ai or Brave Search) since generic endpoints don't expose search natively. You can run that step any time with anton setup-search — see Search providers.

Web search and fetch by provider​

Anton exposes two web tools to the agent — web_search and web_fetch — both on by default. How they execute depends on your provider:

Providerweb_searchweb_fetchSetup
Anthropic BYOKAnthropic native server toolAnthropic native server toolNone — billed on your Anthropic key
OpenAI BYOKOpenAI Responses API nativecovered by web_searchNone — billed on your OpenAI key
MindsHubMindsHub passthroughMindsHub passthroughNone — billed on your MindsHub key
Generic OpenAI-compatible (Together, Groq, Ollama, vLLM, …)Exa.ai or Brave (you choose at setup)stdlib HTTP GET (no key)Run anton setup-search once

To opt out, set ANTON_WEB_SEARCH_ENABLED=false and/or ANTON_WEB_FETCH_ENABLED=false in your config. See Web search and Web fetch.

Switching providers later​

  • In chat: type /llm to change provider, model, or API key.
  • From the terminal: run anton setup to re-run the full provider selection.

Both flows validate the new configuration before saving it to ~/.anton/.env.