Configuration Reference

Configuration Reference

autogen is configured via environment variables. Create a .env file at the repo root. Only GEMINI_API_KEY is required; all other variables have defaults.

Required Variables

Name	Type	Required	Default	Description
GEMINI_API_KEY	string	Yes	—	Gemini API key (primary provider; also read as MAF_API_KEY)

MAF Core Variables

Name	Type	Required	Default	Description
MAF_MODEL	string	No	gemini-2.5-flash	Primary model for agent runs
MAF_BASE_URL	string	No	https://generativelanguage.googleapis.com/v1beta/openai/	API base URL (also read as GEMINI_BASE_URL)
MAF_REPO_ROOT	string	No	.	Repo root path for agent filesystem access
MAF_ENTITIES_DIR	string	No	entities	Directory scanned for DevUI entity discovery
MAF_CHECKPOINT_DIR	string	No	state\maf-checkpoints	Directory for FileCheckpointStorage
MAF_FALLBACK_CHAIN	string	No	Auto-computed	Comma-separated fallback provider chain
MAF_ROUTE_LANE	string	No	auto	Routing lane override: auto, balanced, fast, or deep

Provider Variables

Name	Type	Required	Default	Description
ANTHROPIC_API_KEY	string	No	—	Anthropic API key; enables Claude fallback when set
ANTHROPIC_MODEL	string	No	claude-sonnet-4-6	Anthropic model used when API key is present
GEMINI_CLI_COMMAND	string	No	gemini.cmd	Path or command for the Gemini CLI executable
CLAUDE_CLI_COMMAND	string	No	claude	Path or command for the Claude CLI executable
CODEX_CLI_COMMAND	string	No	codex.cmd	Path or command for the Codex CLI executable

Example .env

# Required
GEMINI_API_KEY=your_gemini_api_key_here

# Optional — override primary model
MAF_MODEL=gemini-2.5-pro

# Optional — enable Anthropic fallback
ANTHROPIC_API_KEY=your_anthropic_api_key_here

# Optional — pin routing lane
MAF_ROUTE_LANE=balanced