Environment Variables
All configuration is managed through environment variables. Create a.env file in the project root:
Configuration Files
Local Configuration
File:configure/local_config.py
Production Configuration
File:configure/production_config.py
Similar structure but with production-specific settings:
- Disabled API documentation (docs_url=None)
- Stricter CORS configuration
- Enhanced logging for monitoring
- Database connection pooling
AI Provider Configuration
Google Gemini
GEMINI_API_KEY: From Google Cloud Console- Model selection: gemini-2.0-flash-exp, gemini-pro, etc.
OpenAI
OPENAI_API_KEY: From OpenAI API dashboard- Model: gpt-4, gpt-3.5-turbo, gpt-4-turbo, etc.
Hume AI (Emotional Intelligence)
HUME_CONFIG_ID: Configuration ID from Hume AIHUME_API_KEY: Public API keyHUME_SECRET_KEY: Secret key for authentication
Telephony Configuration
Twilio
- Create Twilio account at twilio.com
- Get Account SID and Auth Token
- Purchase phone number or verify test number
- Configure webhook URL for incoming calls
Plivo
- Create Plivo account
- Get Auth ID and Token
- Purchase DID number
- Set up message URL
Database Configuration
Supabase
- Create Supabase project
- Copy Project URL and API Key
- Set
SUPABASE_URLandSUPABASE_KEY
Server Configuration
Port Configuration
CORS Configuration
API Documentation
Local Environment:- Swagger UI:
/docs - ReDoc:
/redoc - OpenAPI:
/openapi.json
- Documentation disabled (docs_url=None)
- Use external tools like Postman for API testing
Logging Configuration
Log Levels
Log Output
- Console (stdout)
- File:
logs/app.log(if configured)
MCP Service Configuration
MCP (Model Context Protocol) services handle external integrations:Telegram MCP
integrations/mcp_tele/config.json
Gmail MCP
integrations/mcp_gmail/credentials.json
WhatsApp MCP
integrations/mcp_whatsapp/database.py
Agent Configuration
System Prompts
Voice Configuration
Security Configuration
API Keys
Best practices:- Use environment variables, never commit keys
- Rotate keys regularly
- Use different keys for dev/prod
- Store in
.envfile (add to .gitignore)
CORS
Authentication
Performance Tuning
Worker Configuration
Database Connection Pooling
Cache Configuration
Integration Configuration
Shopify
Payment Provider
Environment-Specific Configs
Development
Staging
Production
Validation
Verify your configuration:Common Issues
Missing API Keys
Connection Failures
Next Steps
Quick Start
Start building with the configured platform.