Darikab7148/-amharic-ai-call-demo

Native Amharic-speaking AI call agent with Twilio and OpenAI integration # Amharic AI Call Agent Demo 🇪🇹 A native Amharic-speaking AI call agent that enables voice-based interactions in the Amharic language using Twilio, OpenAI GPT, and FastAPI. ## 🌟 Features - **🇪🇹 Native Amharic Processing**: Understands and responds in fluent Amharic - **📞 Voice Call Integration**: Seamless Twilio phone call handling - **🤖 AI-Powered Conversations**: OpenAI GPT-4o-mini for intelligent responses - **🎙️ Speech Recognition**: Twilio Gather with Amharic language support - **💬 Cultural Awareness**: Understands Ethiopian context and customs - **💰 Cost-Effective**: Under $10/month operation ## 🚀 Live Demo Call the demo number: [Your Twilio Number Here] Try speaking in Amharic: - "እንደምን አለህ?" (How are you?) - "ስለ ኢትዮጵያ ነገር ሊመጣ?" (Can you tell me about Ethiopia?) - "የዛሬ የአየር ሁኔታ እንዴት ነው?" (How's the weather today?) ## 🏗️ Technology Stack - **FastAPI**: Modern Python web framework - **OpenAI GPT-4o-mini**: Conversational AI in Amharic - **Twilio**: Voice call handling and speech processing - **Railway.app**: Cloud deployment platform - **Python 3.11**: Runtime environment ## 📱 How It Works 1. **📞 Incoming Call**: Twilio receives voice call 2. **🎤 Speech Recognition**: Converts Amharic speech to text 3. **🧠 AI Processing**: OpenAI generates culturally-aware Amharic response 4. **🔊 Text-to-Speech**: Twilio converts response back to speech 5. **💬 Continuous Conversation**: Supports back-and-forth dialogue ## ⚡ Quick Deploy to Railway ### Environment Variables Required: - `OPENAI_API_KEY`: Your OpenAI API key ## 🛠️ Local Development ### Prerequisites - Python 3.11+ - OpenAI API key - Twilio account - ngrok (for local development) ### Setup 1. **Clone repository**: ```bash git clone github.com cd amharic-ai-call-demo ``` 2. **Install dependencies**: ```bash pip install -r requirements.txt ``` 3. **Set environment variables**: ```bash export OPENAI_API_KEY="your-openai-api-key" ``` 4. **Run the ser …