scourtain/moteur-de-reels

Configuration des reels

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" HOME = $REELS_HOME si défini, sinon ~/Movies/Reels sur Mac et ~/Videos/Reels sur Windows. ENGINE init-home affiche le chemin. Dans les commandes, mettez toujours les chemins HOME et PROJECT entre guillemets, écrits en entier comme le moteur les affiche (un ~ entre guillemets ne fonctionne pas). Sur Windows, ils contiennent des barres obliques inverses et souvent des espaces, ce qui casse sans les guillemets.

Sur Windows (vérifiez avec uname -s : commence par MINGW ou MSYS dans le shell de Claude Code sous Windows), sautez les étapes 1 et 2 ci-dessous et faites plutôt ceci :

• Node et ffmpeg : vérifiez node --version (22 ou plus récent) et ffmpeg -version. Installez ce qui manque avec winget install --id OpenJS.NodeJS.LTS -e et winget install --id Gyan.FFmpeg -e. Windows peut afficher une fenêtre « Voulez-vous autoriser cette application à apporter des modifications » : le membre clique sur Oui. Si un outil n'est toujours pas trouvé juste après l'installation, le moteur cherche aussi dans le dossier de winget ; si ENGINE doctor le montre toujours en rouge, demandez au membre de fermer et rouvrir Claude, puis vérifiez à nouveau.
• Whisper (le transcripteur) : trouvez le téléchargement Windows avec curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest et prenez l'asset nommé exactement whisper-bin-x64.zip. Si aucun asset n'a ce nom, arrêtez-vous et dites au membre : « La configuration Windows a besoin d'une mise à jour pour le dernier téléchargement Whisper. Sam a été prévenu. » Sinon, faites mkdir -p "HOME/tools/whisper", curl -L --fail -o "HOME/tools/whisper.zip" <l'URL browser_download_url de l'asset>, /c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper" (le tar de Windows lit les fichiers zip ; celui fourni avec Git Bash ne le fait pas), puis supprimez le zip. Vérifiez que whisper-cli.exe est bien présent : ls "HOME/tools/whisper" "HOME/tools/whisper/Release". S'il n'est dans aucun des deux dossiers, arrêtez-vous et dites au membre le même message : « La configuration Windows a besoin d'une mise à jour pour le dernier téléchargement Whisper. Sam a été prévenu. » ENGINE doctor devrait maintenant afficher whisper-cli en vert.
• Puis continuez à partir de l'étape 3 ci-dessous. Dans ENGINE doctor, la ligne optionnelle – person cutout indique « seulement sur Mac pour l'instant » : dites au membre une fois : « Les deux looks de crochet qui mettent du texte derrière votre tête sont uniquement sur Mac pour l'instant. Les quatre autres fonctionnent. » Ne proposez aucune solution pour cela.

1. Homebrew (l'installateur d'outils) : vérifiez which brew, puis /opt/homebrew/bin/brew et /usr/local/bin/brew. Si aucun n'existe, le membre l'installe avec un installateur Mac normal, sans Terminal : envoyez-le sur https://github.com/Homebrew/brew/releases/latest, faites-lui télécharger le fichier se terminant par .pkg, double-cliquer dessus et cliquer sur les boutons (cela demande son mot de passe Mac dans la fenêtre Mac habituelle ; vous ne tapez ni ne demandez jamais le mot de passe). Attendez qu'il dise que c'est fait, puis vérifiez à nouveau. Si brew n'est toujours pas trouvé par son nom, appelez-le par son chemin complet (/opt/homebrew/bin/brew) pour l'étape suivante.
2. Outils : brew install node ffmpeg whisper-cpp (sautez ce qui est déjà présent). Ensuite ENGINE doctor. Corrigez tout ce qui est rouge en utilisant son indice fix.
   • Une ligne commençant par – est optionnelle. – person cutout signifie que deux looks de carte crochet (texte derrière votre tête) sont désactivés sur ce Mac ; tout le reste fonctionne. Proposez la correction une fois : « Vous voulez les deux looks de crochet derrière la tête ? Lancez xcode-select --install dans le Terminal, cliquez sur Installer, puis dites 'vérifie à nouveau'. » Ne bloquez pas la configuration dessus.
3. Navigateur de rendu + modèle vocal (téléchargements uniques, environ 700 Mo) : exécutez npx -y [email protected] browser ensure. Ensuite, assurez-vous que le modèle vocal est présent : vérifiez ~/.cache/hyperframes/whisper/models/ggml-small.en.bin ou HOME/models/ggml-small.en.bin. Si aucun n'existe, téléchargez-le : mkdir -p "HOME/models" && curl -L --fail -o "HOME/models/ggml-small.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.en.bin
4. Espace de travail : ENGINE init-home. Cela affiche le dossier Reels et n'écrase jamais les fichiers existants.
5. Les bases, une question à la fois, sauvegardées dans HOME/brand-kit.json (conservez toutes les autres clés déjà présentes dans le fichier) :
   • Pseudo Instagram → handle
   • Durée par défaut du reel en secondes (valeur par défaut 40) → default_target_seconds
6. Vocabulaire : demandez les noms, outils et mots de marque qu'ils disent souvent (nom de leur entreprise, produits, applications). Écrivez-les un par ligne dans HOME/vocabulary.txt pour que la transcription les épelle correctement.
7. Leur style. Lancez l'entretien de style dans ../reel-style/references/style-interview.md : cela ouvre la page de sélection des légendes, et ce qu'ils choisissent devient leur style par défaut. Ne demandez pas d'exemple de reel ou de lien. Sautez l'étape de nommage de l'entretien : le style est toujours main (écrivez-le directement dans HOME/styles/main.json, pas de draft). Ne proposez pas un deuxième style ; ils pourront en ajouter un plus tard avec /reels-engine:reel-style.
8. Terminez par : « Vous êtes prêt. Faites glisser 1 à 4 clips dans le chat et dites "nouveau reel" (ou tapez /reels-engine:reel). »

Réexécuter est sans danger : passez ce qui est déjà fait. Ne redemandez les bases que s'ils veulent les changer, et envoyez les modifications de style vers /reels-engine:reel-style.