Mirage - Voice AI Avatar Platform

Real-time voice AI backend with animated avatar responses.

Architecture

User (Browser) ←→ LiveKit ←→ Mirage Backend ←→ Gemini 2.0 Flash
                                    ↓
                              Simli Avatar

Quick Start

1. Setup Environment

cd Mirage
python -m venv venv
source venv/bin/activate  # Linux/Mac
pip install -r requirements.txt

2. Configure API Keys

cp .env.example .env
# Edit .env with your API keys

3. Run Database Migrations

Run SQL files from supabase-schema.sql in the Supabase SQL Editor.

4. Start Frontend

cd agent-frontend
pnpm install
pnpm dev

5. Start Agent Worker

cd agent
python worker.py dev

Components

• agent-frontend/ - Next.js Web App with Supabase Client & LiveKit interface
• agent/ - LiveKit agent worker (Gemini + Simli)

API Keys Required

• Supabase - Database & Auth
• LiveKit - Real-time audio/video
• Google AI Studio - Gemini API
• Simli - Avatar animation