hassetshi/amharic-voice-agent

# 🇪🇹 Amazon Consulting — Amharic Voice Agent Bilingual English + Amharic voice agent for Amazon Consulting LLC Silver Spring, MD | (240) 641-1515 | dmvamazon.com --- ## Project Structure ``` amharic-voice-agent/ ├── main.py ← Entry point — run this ├── requirements.txt ← Python deps ├── .env.example ← Copy to .env and fill keys ├── .env ← YOUR keys (never commit!) │ ├── src/ │ ├── app.py ← FastAPI factory │ ├── config.py ← All env vars + validation │ ├── prompts.py ← Amharic + English scripts │ ├── session.py ← Call session state manager │ ├── services.py ← STT / LLM / TTS / GHL │ └── routes/ │ ├── health_routes.py ← /health /test-amharic /test-chat │ └── call_routes.py ← /incoming-call + WebSocket │ ├── tests/ │ └── test_all.py ← Full test suite │ ├── audio_samples/ ← Generated MP3 test files └── .vscode/ ├── launch.json ← Debug configs └── settings.json ← Python settings ``` --- ## Setup in VS Code — Step by Step ### Step 1 — Open Project ```bash # Open VS Code in the project folder code amharic-voice-agent ``` Or: File → Open Folder → select `amharic-voice-agent` --- ### Step 2 — Create Virtual Environment Open VS Code terminal (`Ctrl+`` ` or Terminal → New Terminal): ```bash # Create venv python3 -m venv venv # Activate (Mac/Linux) source venv/bin/activate # Activate (Windows) venv\Scripts\activate # You should see (venv) in your terminal prompt ``` --- ### Step 3 — Install Dependencies ```bash pip install -r requirements.txt ``` Takes 2-3 minutes. You'll see packages installing. --- ### Step 4 — Set Up API Keys ```bash # Copy the template cp .env.example .env # Open .env and fill in your keys code .env ``` Fill in these keys (get them from each service): | Key | Where to get it | |-----|----------------| | `DEEPGRAM_API_KEY` | console.deepgram …