Configuring config.toml — Andromity Docs

Configuration

Andromity reads settings from a global configuration file located at ~/.andromity/config.toml. This file is created automatically on your first run.

Configuration File Schema

Here is a fully documented config.toml structure containing all options:

TOML

[default]
provider = "anthropic"            # Active provider key name
model    = "claude-sonnet-4-5"     # Active model name
profile  = "builder"              # Default agent profile (builder/coder/reviewer/planner)
mode     = "safe"                 # Default permission mode (safe/trust/full/yolo)
theme    = "terminal-dark"        # TUI theme selector

# Providers configurations
[[providers]]
name = "anthropic"
type = "anthropic"
api_key = "sk-ant-..."

[[providers]]
name = "openai"
type = "openai"
api_key = "sk-..."

[[providers]]
name = "gemini"
type = "google"
api_key = "AIzaSy..."

[[providers]]
name = "openrouter"
type = "openrouter"
api_key = "sk-or-v1-..."

[[providers]]
name = "ollama"
type = "ollama"
base_url = "http://localhost:11434"

Environment Variables

If you prefer not to write API keys to config files, Andromity will fall back to environment variables:

BASH

export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="AIzaSy..."
export OPENROUTER_API_KEY="sk-or-v1-..."
export GROQ_API_KEY="gsk_..."