Environment variable reference

Use .env.example as the value-level template and Configuration for setup instructions. src/lib/config.ts validates web and budget configuration; agent/harmonia_agent/config.py validates worker settings.

Domain	Purpose	Typical requirement
Firebase and Firestore	Operator sessions and durable tenant data	Required outside local emulators
Google Cloud	Project, region, storage, Pub/Sub, Cloud Run	Required for cloud runtime
Gemini / Vertex AI	Agent and media model access	Required for real model calls
Internal service auth	Web-to-worker and scheduler authentication	Required outside local development
X	OAuth and official API publishing/read-back	Only when X is enabled
Telegram	Bot webhook and allow-listed chat	Only when Telegram is enabled
Google Calendar	OAuth client and redirect configuration	Only for explicit calendar sync
Budgets and models	Catalog, ceilings, approval thresholds	Required for paid operations

Secrets belong in server-side environment injection or Secret Manager. Never expose them through NEXT_PUBLIC_*, documentation, logs, or evidence artifacts.

Integration reference

Workflow contracts

Evidence

Environment variable reference