.env.example

# Echo Mind Backend Environment Variables
# Phase 1.1: Backend Architecture Setup
# Copy this file to .env and fill in your actual API keys

# =============================================================================
# REQUIRED API KEYS
# =============================================================================

# Deepgram API Key for Speech-to-Text
# Get your API key from: https://console.deepgram.com/
DEEPGRAM_API_KEY=your_deepgram_api_key_here

# OpenAI API Key for LLM processing
# Get your API key from: https://platform.openai.com/api-keys
OPENAI_API_KEY=your_openai_api_key_here

# ElevenLabs API Key for Text-to-Speech
# Get your API key from: https://elevenlabs.io/
ELEVENLABS_API_KEY=your_elevenlabs_api_key_here

# HeyGen API Key for Avatar Video Generation
# Get your API key from: https://app.heygen.com/
HEYGEN_API_KEY=your_heygen_api_key_here

# Brave Search API Key for Web Search
# Get your API key from: https://api.search.brave.com/
BRAVE_API_KEY=your_brave_api_key_here

# =============================================================================
# SERVER CONFIGURATION
# =============================================================================

# Server host and port
HOST=0.0.0.0
PORT=8000

# Number of worker processes (for production)
WORKERS=1

# Environment (development, staging, production)
ENVIRONMENT=development

# =============================================================================
# AUDIO PROCESSING CONFIGURATION
# =============================================================================

# Voice Activity Detection (VAD) Settings
VAD_MIN_VOLUME=0.6
VAD_START_SECS=0.2
VAD_STOP_SECS=1.2
VAD_CONFIDENCE=0.7

# Audio Buffer Settings (in milliseconds)
AUDIO_BUFFER_THRESHOLD_MS=1000
MIN_AUDIO_DURATION_MS=80

# =============================================================================
# SERVICE CONFIGURATION
# =============================================================================

# Deepgram Configuration
DEEPGRAM_MODEL=nova-2-conversationalai
DEEPGRAM_LANGUAGE=en-US
DEEPGRAM_SAMPLE_RATE=16000

# OpenAI Configuration
OPENAI_MODEL=gpt-4o-mini
OPENAI_MAX_TOKENS=1000
OPENAI_TEMPERATURE=0.7

# ElevenLabs Configuration
ELEVENLABS_VOICE_ID=29vD33N1CtxCmqQRPOHJ
ELEVENLABS_OUTPUT_FORMAT=pcm_24000
ELEVENLABS_STABILITY=0.5
ELEVENLABS_SIMILARITY_BOOST=0.75
ELEVENLABS_OPTIMIZE_LATENCY=4

# HeyGen Configuration
HEYGEN_API_BASE_URL=https://api.heygen.com
HEYGEN_QUALITY=high
HEYGEN_AVATAR_NAME=default_avatar

# =============================================================================
# PERFORMANCE TUNING
# =============================================================================

# Pipeline Settings
ALLOW_INTERRUPTIONS=true
ENABLE_METRICS=true
ENABLE_USAGE_METRICS=true

# WebSocket Settings
WS_PING_INTERVAL=30
WS_PING_TIMEOUT=10
WS_CLOSE_TIMEOUT=10

# =============================================================================
# LOGGING CONFIGURATION
# =============================================================================

# Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
LOG_LEVEL=INFO

# Enable structured JSON logging
JSON_LOGGING=false

# Log file path (optional, logs to console if not set)
# LOG_FILE=/var/log/echo-mind/backend.log

# =============================================================================
# CORS CONFIGURATION
# =============================================================================

# Allowed origins for CORS (comma-separated)
# Use "*" for development, specific domains for production
CORS_ORIGINS=*

# =============================================================================
# SECURITY CONFIGURATION
# =============================================================================

# API rate limiting (requests per minute)
RATE_LIMIT_PER_MINUTE=60

# Maximum WebSocket connections per IP
MAX_CONNECTIONS_PER_IP=5

# Session timeout (in seconds)
SESSION_TIMEOUT=3600

# =============================================================================
# MONITORING AND HEALTH CHECKS
# =============================================================================

# Health check endpoint path
HEALTH_CHECK_PATH=/api/v1/health

# Enable Prometheus metrics
ENABLE_PROMETHEUS=false

# Metrics endpoint path
METRICS_PATH=/metrics

# =============================================================================
# DEVELOPMENT SETTINGS
# =============================================================================

# Enable auto-reload in development
AUTO_RELOAD=true

# Enable debug mode
DEBUG=false

# Enable API documentation
ENABLE_DOCS=true

# =============================================================================
# OPTIONAL: CUSTOM TOOL CONFIGURATION
# =============================================================================

# Weather API key (for weather tool - Phase 1.2)
# WEATHER_API_KEY=your_weather_api_key_here

# Calendar API credentials (for calendar tool - Phase 1.2)
# CALENDAR_CLIENT_ID=your_calendar_client_id_here
# CALENDAR_CLIENT_SECRET=your_calendar_client_secret_here

# =============================================================================
# MEMOS REST API CONFIGURATION
# =============================================================================

# memOS REST API Configuration
MEMOS_REST_URL=http://localhost:8080
MEMOS_API_KEY=your_memos_api_key_here
USE_MEMOS=false  # Set to true to enable memOS REST API integration

# =============================================================================
# NOTES
# =============================================================================

# 1. Never commit the actual .env file to version control
# 2. Keep your API keys secure and rotate them regularly
# 3. Use different API keys for development and production
# 4. Monitor your API usage to avoid unexpected charges
# 5. Test all integrations before deploying to production