Skip to main content

Environment variables

Every Anton setting can be set as an environment variable with the ANTON_ prefix. Most users never touch these directly — the anton setup and anton setup-search flows write them to the right .env file for you — but they are all available for scripting and overrides.

The .env loading chain

Anton reads configuration from three locations:

  1. .env in the current directory
  2. .anton/.env in the workspace (project-local config)
  3. ~/.anton/.env (global config — LLM keys, search keys)

Variables set in your actual shell environment always take precedence over values from any file. Setup flows write LLM and search provider keys to the global file so they carry across workspaces, and workspace-specific settings to the local one.

Providers and models

VariableDefaultWhat it does
ANTON_PLANNING_PROVIDERanthropicProvider for the planning model (anthropic, openai, openai-compatible)
ANTON_PLANNING_MODELclaude-sonnet-4-6Model used for planning and conversation
ANTON_CODING_PROVIDERanthropicProvider for the coding model
ANTON_CODING_MODELclaude-haiku-4-5-20251001Model used for code generation in the scratchpad
ANTON_MAX_TOKENS8192Max output tokens per LLM call
ANTON_ANTHROPIC_API_KEYunsetAnthropic API key
ANTON_OPENAI_API_KEYunsetOpenAI (or OpenAI-compatible endpoint) API key
ANTON_OPENAI_BASE_URLunsetBase URL for an OpenAI-compatible endpoint
ANTON_OPENAI_API_VERSIONunsetAzure OpenAI api-version query parameter
ANTON_MINDS_ENABLEDtrueAllow using a Minds server as LLM provider
ANTON_MINDS_API_KEYunsetMinds API key
ANTON_MINDS_URLMinds cloud URLMinds server URL
ANTON_MINDS_MIND_NAMEunsetMind name to use on the Minds server
ANTON_MINDS_SSL_VERIFYtrueVerify SSL certificates when talking to the Minds server

Web tools

VariableDefaultWhat it does
ANTON_WEB_SEARCH_ENABLEDtrueEnable the web_search tool — see Web search
ANTON_WEB_FETCH_ENABLEDtrueEnable the web_fetch tool — see Web fetch
ANTON_EXTERNAL_SEARCH_PROVIDERunsetExternal search provider for generic endpoints: exa or brave
ANTON_EXA_API_KEYunsetExa.ai API key
ANTON_BRAVE_API_KEYunsetBrave Search API key

The search provider variables are normally written by anton setup-search — see Search providers.

Memory

VariableDefaultWhat it does
ANTON_MEMORY_ENABLEDtrueMaster switch for the memory system
ANTON_MEMORY_MODEautopilotHow lessons are saved: autopilot, copilot, or off — see Memory overview
ANTON_EPISODIC_MEMORYtrueKeep an episode archive of past sessions — see Episodes and recall

Behavior

VariableDefaultWhat it does
ANTON_THEMEautoTerminal color theme
ANTON_DISABLE_AUTOUPDATESfalseSkip automatic update checks — see Updating
ANTON_ANALYTICS_ENABLEDtrueAnonymous usage events — see Analytics
ANTON_LANGFUSE_HEADERSunsetSet to 1 to attach Langfuse trace headers on any OpenAI-compatible endpoint — see Trace headers
ANTON_PROACTIVE_DASHBOARDSfalseWhen true, Anton builds HTML dashboards proactively; when false, CLI output only
ANTON_BACKENDlocalScratchpad backend: local or remote (remote requires Minds URL and API key)
ANTON_PUBLISH_URLhttps://4nton.aiPublish service used when sharing artifacts
ANTON_TERMS_CONSENTfalseRecords that you accepted the terms screen (set by the first-run flow)
ANTON_FIRST_RUN_DONEfalseRecords that first-run onboarding completed (set by the setup flow)

A few additional internal tuning variables exist (tool-round limits, cell timeouts); they are intentionally undocumented here as they are not meant for everyday configuration.