README.md

---
title: CapsulesVideo
emoji: 🌍
colorFrom: purple
colorTo: red
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# 🎬 CPAS Bruxelles – Créateur de Capsules (SadTalker + Kokoro)

Application Gradio permettant de générer des capsules vidéo avec :
- 🎙️ Synthèse vocale naturelle **Kokoro** (offline) ou **gTTS** (en ligne)
- 🧑‍💼 Animation faciale **SadTalker** à partir d’une image portrait
- 🧾 Texte à l’écran + sous-titres .srt
- 🧰 Outils d’assemblage de plusieurs capsules

## 🚀 Démarrage rapide (Hugging Face Spaces)
1. Uploadez ces fichiers à la racine : `app.py`, `requirements.txt`, `app_config.json`, `.gitattributes`
2. **Ajoutez le dossier `SadTalker/`** à la racine du Space, avec les checkpoints dans `SadTalker/checkpoints/` :


> Astuce : activez **“Persistent storage”** dans les paramètres du Space pour ne pas recharger à chaque fois.

## 🧠 Pourquoi Kokoro ?
- Voix très naturelle, **fonctionne offline** (après téléchargement du modèle)
- Alternative à Edge-TTS (cloud) pour plus de stabilité en Space

## ⚠️ Notes
- Si le dossier `SadTalker/` n’est pas présent, l’app fonctionne quand même (sans visage animé).
- Si Kokoro échoue (modèle non chargé), l’app bascule automatiquement sur **gTTS**.