AvaTar

Interactive AI Avatar System with Real-time Streaming

πŸš€ Live Demos

πŸ“š Documentation

πŸ—οΈ Architecture Overview

AvaTar uses a microservices architecture designed for scalability and real-time performance:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Web Client    │────▢│   FastAPI       │────▢│  Redis Queue    β”‚
β”‚  (JavaScript)   │◀────│   Backend       │◀────│  & Pub/Sub      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚                       β”‚                         β”‚
         β”‚                       β–Ό                         β–Ό
         β”‚              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         └─────────────▢│  WebSocket      β”‚     β”‚  Linly-Talker   β”‚
                        β”‚   Server        β”‚     β”‚  (Lip Sync)     β”‚
                        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
🐍 Python/FastAPI πŸ”„ WebSocket πŸ“¦ Redis 🐳 Docker 🎯 WebRTC πŸ€– AI/ML πŸ”Š 11Labs TTS 🧠 OpenAI/Anthropic

⚑ Quick Start

# Clone the repository

git clone https://github.com/yourusername/AvaTar.git

cd AvaTar


# Start with Docker Compose

docker-compose -f docker-compose-simple.yml up -d


# Check health

curl http://localhost:8000/health


# Open demo

open http://localhost:8080