ClipForge

Création de shorts viraux en local, avec Raspberry Pi en workers.

Objectif

• Ingest de sources vidéo (YouTube, Dailymotion, fichiers locaux).
• Transcription, script court, TTS, montage, rendu.
• Export local et publication manuelle au début.

Structure du repo

• api/ API et orchestrateur (Node.js / NestJS léger)
• workers/ tâches média (Python)
• ingest/, stt/, script/, tts/, edit/, render/, publish/
• templates/ presets pour FFmpeg (YAML)
• shared/ assets, polices, b-roll, rendus, sous-titres
• configs/ fichiers d'exemple de config/env
• docs/ documentation technique et guides

Démarrage rapide (local)

API

1. Ouvre api/ et installe les dépendances.
2. Génère et initialise la base SQLite via Prisma.
3. Démarre en dev.

cd api
npm install
npx prisma generate
npx prisma migrate dev --name init
npm run dev

Vérifie la santé:

curl http://localhost:3000/health

Workers (conda)

1. Installe Miniforge/Conda.
2. Crée l'environnement depuis workers/environment.yml.
3. Active l'environnement avant toute commande Python.

cd workers
conda env create -f environment.yml
conda activate clipforge

Tester l'ingest:

python ingest/ingest.py --url https://www.youtube.com/watch?v=dQw4w9WgXcQ --out ./shared/renders/test.mp4

Plus de détails dans docs/.