README.md

---
title: HOLOKIA-AVATAR
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
short_description: Avatar 3D intelligent avec IA conversationnelle
---

# 🤖 HOLOKIA-AVATAR - Avatar 3D Interactif

Un avatar 3D intelligent avec capacités de conversation en temps réel, utilisant l'IA pour des interactions naturelles.

## ✨ Fonctionnalités

- 🎭 **Avatar 3D interactif** avec synchronisation labiale
- 🗣️ **Reconnaissance vocale** (Speech-to-Text)
- 🔊 **Synthèse vocale** (Text-to-Speech)
- 🧠 **IA conversationnelle** (Groq LLM)
- 📡 **Streaming temps réel** via WebSocket
- 🌐 **Interface web moderne** avec React et Three.js

## 🚀 Utilisation

1. **Parlez** à l'avatar via le microphone
2. **L'avatar écoute** et comprend votre message
3. **L'IA génère** une réponse intelligente
4. **L'avatar parle** avec synchronisation labiale
5. **Interaction continue** en temps réel

## 🔧 Configuration

Ajoutez votre clé API Groq dans les **Secrets** du Space :
- Nom : `GROQ_API_KEY`
- Valeur : `gsk_...` (votre clé API)

## 📄 Licence

MIT License

---

**Développé avec ❤️ par l'équipe HOLOKIA**