Skip to main content

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

Required Settings:
  • GEMINI_API_KEY: From Google Cloud Console
  • Model selection: gemini-2.0-flash-exp, gemini-pro, etc.

OpenAI

Required Settings:
  • OPENAI_API_KEY: From OpenAI API dashboard
  • Model: gpt-4, gpt-3.5-turbo, gpt-4-turbo, etc.

Hume AI (Emotional Intelligence)

Required Settings:
  • HUME_CONFIG_ID: Configuration ID from Hume AI
  • HUME_API_KEY: Public API key
  • HUME_SECRET_KEY: Secret key for authentication

Telephony Configuration

Twilio

Setup Steps:
  1. Create Twilio account at twilio.com
  2. Get Account SID and Auth Token
  3. Purchase phone number or verify test number
  4. Configure webhook URL for incoming calls

Plivo

Setup Steps:
  1. Create Plivo account
  2. Get Auth ID and Token
  3. Purchase DID number
  4. Set up message URL

Database Configuration

Supabase

Setup Steps:
  1. Create Supabase project
  2. Copy Project URL and API Key
  3. Set SUPABASE_URL and SUPABASE_KEY

Server Configuration

Port Configuration

CORS Configuration

API Documentation

Local Environment:
  • Swagger UI: /docs
  • ReDoc: /redoc
  • OpenAPI: /openapi.json
Production Environment:
  • Documentation disabled (docs_url=None)
  • Use external tools like Postman for API testing

Logging Configuration

Log Levels

Log Output

Logs are written to:
  • Console (stdout)
  • File: logs/app.log (if configured)

MCP Service Configuration

MCP (Model Context Protocol) services handle external integrations:

Telegram MCP

Configuration file: integrations/mcp_tele/config.json

Gmail MCP

OAuth credentials: integrations/mcp_gmail/credentials.json

WhatsApp MCP

Database configuration: 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 .env file (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.