Configuration

Configuration

Config file: ~/.titan/titan.json

Minimal Config

{
  "agent": { "model": "anthropic/claude-sonnet-4-20250514" },
  "gateway": { "port": 48420, "auth": { "mode": "password", "password": "your-password" } }
}

Environment Variables

Variable	Purpose
ANTHROPIC_API_KEY	Claude API key
OPENAI_API_KEY	GPT API key
GOOGLE_API_KEY	Gemini API key
OLLAMA_BASE_URL	Ollama server URL
GROQ_API_KEY	Groq API key
MISTRAL_API_KEY	Mistral API key
OPENROUTER_API_KEY	OpenRouter API key
FIREWORKS_API_KEY	Fireworks AI key
XAI_API_KEY	xAI (Grok) key
TOGETHER_API_KEY	Together AI key
DEEPSEEK_API_KEY	DeepSeek key
CEREBRAS_API_KEY	Cerebras key
COHERE_API_KEY	Cohere key
PERPLEXITY_API_KEY	Perplexity key
GITHUB_TOKEN	GitHub PAT
GMAIL_ADDRESS / GMAIL_APP_PASSWORD	Email
HOME_ASSISTANT_URL / HOME_ASSISTANT_TOKEN	Smart home
GOOGLE_CALENDAR_API_KEY	Calendar
DISCORD_TOKEN / TELEGRAM_TOKEN / SLACK_TOKEN	Channels

Model Aliases

{ "agent": { "modelAliases": { "fast": "openai/gpt-4o-mini", "smart": "anthropic/claude-sonnet-4-20250514" } } }

Use: /model fast or titan model --alias fast openai/gpt-4o-mini

Auth Profile Rotation

{ "providers": { "anthropic": { "apiKey": "primary", "profiles": [{ "apiKey": "backup1" }] } } }

Auto-rotates on errors with 60s cooldown.

Model Allowlisting

{ "agent": { "allowedModels": ["anthropic/*", "openai/gpt-4o"] } }