sunona

# Sunona Voice AI

<p align="center">
  <strong>🎙️ Enterprise-Grade Voice AI Platform</strong><br>
  Build conversational voice assistants with real-time STT, LLM, and TTS
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.9+-blue.svg" alt="Python">
  <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License">
  <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg" alt="Platform">
  <img src="https://img.shields.io/github/stars/Sunona-AI-labs/sunona?style=social" alt="GitHub Stars">
</p>

---

## 🎬 Demo

### 🎤 Voice Assistant Examples

https://github.com/user-attachments/assets/613a9942-7c3b-48ba-8a26-9f9614430424

> 🎙️ **This demo showcases Sunona's voice assistants** — `simple_assistant.py`, `voice_assistant.py`, and `text_only_assistant.py` with real-time STT, LLM, and TTS.

---

### 📞 Twilio Phone Call Demo

https://github.com/user-attachments/assets/7f9da85f-72e3-4168-8021-eaf311e6fa3a

> 📞 **This demo showcases Sunona's Twilio integration** — an AI campus recruiter (Priya) making real phone calls with voice conversation.

### 🔧 Required Setup to Replicate This Demo

**1. Environment Variables (`.env`):**

```bash
# LLM (Brain) - Primary: Groq (fastest), Fallback: OpenRouter
GROQ_API_KEY=gsk_xxxxxxxx              # https://console.groq.com/keys
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxx   # https://openrouter.ai/keys (fallback)

# STT (Ears) - https://console.deepgram.com/
DEEPGRAM_API_KEY=xxxxxxxx

# TTS (Voice) - https://elevenlabs.io/app/settings/api-keys
ELEVENLABS_API_KEY=xxxxxxxx

# Telephony - https://www.twilio.com/console
TWILIO_ACCOUNT_SID=ACxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxx
TWILIO_PHONE_NUMBER=+1xxxxxxxxxx
TWILIO_WEBHOOK_URL=https://your-ngrok-url.ngrok-free.app

# Ngrok (for local testing) - https://dashboard.ngrok.com/
NGROK_AUTH_TOKEN=xxxxxxxx
```

**2. Agent Configuration Used:**
- **Config**: [`agent_data/example_recruiter/config_minimal.json`](agent_data/ex