Configuration Reference

Configuration Reference

All settings are loaded from .env via Pydantic-settings. See .env.example for the full annotated list.

---

Required Variables

Variable	Description	Example
SECRET_KEY	JWT signing secret (HS256)	openssl rand -hex 32
DATABASE_URL	SQLAlchemy connection string	sqlite:///./data/amadeus.db
REDIS_URL	Redis connection URL	redis://localhost:6379/0

Tip: Run Setup_Amadeus.bat on Windows to auto-generate a secure SECRET_KEY.

---

LLM Providers

Configure at least one. Priority order: LlamaCpp → Ollama → Groq → Gemini → OpenAI.

Variable	Provider	Free?	Notes
SLM_MODEL_PATH	LlamaCpp (local GGUF)	✅ Unlimited	Path to .gguf file
OLLAMA_MODEL	Ollama (local server)	✅ Unlimited	e.g. llama3.2
OLLAMA_ENABLED	Enable/disable Ollama	—	true / false
GROQ_API_KEY	Groq — Llama 3.3 70B	✅ 14,400 req/day	Free tier
GEMINI_API_KEY	Gemini 2.5 Flash	✅ 1,500 req/day	Free tier
OPENAI_API_KEY	GPT-4o-mini	❌ Paid	Emergency fallback

Local-Only Mode

Disable all cloud providers entirely:

LOCAL_ONLY_MODE=true

---

Core Settings

Variable	Default	Description
ENV	development	development or production
DEBUG	false	Enables /docs Swagger UI
LOG_LEVEL	INFO	Logging verbosity
HOST	0.0.0.0	Server bind address
PORT	8000	Server port
DATA_DIR	./data	Base data directory

---

Optional Integrations

Variable	Purpose
TELEGRAM_BOT_TOKEN	Enable Telegram long-polling
MASTER_TELEGRAM_CHAT_ID	Receive proactive scheduled briefings
WHATSAPP_ACCESS_TOKEN	WhatsApp Cloud API token
WHATSAPP_PHONE_NUMBER_ID	WhatsApp sender phone number ID
WHATSAPP_VERIFY_TOKEN	Meta webhook verification token
EMAIL_ADDRESS	IMAP read + SMTP send address
EMAIL_APP_PASSWORD	Gmail App Password or SMTP password
EMAIL_IMAP_SERVER	IMAP server (e.g. imap.gmail.com)
EMAIL_SMTP_SERVER	SMTP server (e.g. smtp.gmail.com)
EMAIL_SMTP_PORT	SMTP port (e.g. 587)
WEATHER_API_KEY	OpenWeatherMap — get_weather tool
NEWS_API_KEY	NewsAPI — get_news tool
TAVILY_API_KEY	Deep web search fallback
SENTRY_DSN	Error monitoring (optional)
QDRANT_URL	External Qdrant server (default: local file-based)
CHROMA_ENABLED	Enable/disable long-term semantic memory
SEARCH_ALLOWED_DIRS	Comma-separated dirs for search_file tool
PROACTIVE_CHECK_INTERVAL_MINUTES	APScheduler interval for proactive loop (default 30)

---

Voice Settings

Variable	Default	Description
WHISPER_MODEL	small	faster-whisper model size
WHISPER_DEVICE	cpu	cpu or cuda
TTS_VOICE	en-US-JennyNeural	Edge TTS voice

---

← Quick-Start | Core-Systems →