.env.example

# Copy this file to `.env` and replace the placeholder values with credentials
# from your own cloud accounts. All variables are read by `app.settings.EnvSettings`.

# --- Required secrets ---------------------------------------------------------
OPENAI_API_KEY=sk-openai-placeholder       # OpenAI API key for language models
TWILIO_AUTH_TOKEN=twilio-token-placeholder # Used to validate Twilio webhooks

# --- Recommended (enables additional functionality) ---------------------------
TWILIO_ACCOUNT_SID=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXX # Required for Twilio REST calls
TAVILY_API_KEY=tavily-placeholder                     # Enables web search tools

# --- Google Workspace integrations -------------------------------------------
# Provide these if you enable the Gmail/Docs/Calendar tools. The service-account
# key should live outside the repo (e.g., in a local `secrets/` directory or
# Secret Manager) and the path here should point to that file.
GMAIL_SA_KEY_PATH=/secure/path/gmail-sa-key.json
GMAIL_IMPERSONATE_EMAIL=user@example.com

# --- Optional deployment overrides -------------------------------------------
# Values consumed by the deployment scripts. Override per environment as needed.
DEPLOY_PROJECT_ID=ringdown-sandbox
DEPLOY_REGION=us-central1
DEPLOY_SERVICE=ringdown-api
DEPLOY_AUTO_APPROVE=false

# --- Live integration tests --------------------------------------------------
# Used by tests/live_test_call.py to locate the Cloud Run service when running
# live Twilio integration checks. Set these to your demo environment (or rely on
# your gcloud default project if you prefer not to store them here).
LIVE_TEST_PROJECT_ID=
LIVE_TEST_SERVICE_NAME=
LIVE_TEST_SERVICE_REGION=