scourtain/reels-engine

Reel-Einrichtung

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" HOME = $REELS_HOME falls gesetzt, sonst ~/Movies/Reels auf dem Mac und ~/Videos/Reels auf Windows. ENGINE init-home gibt es aus. In Befehlen immer HOME- und PROJECT-Pfade in doppelte Anführungszeichen setzen, voll ausgeschrieben, wie die Engine sie ausgibt (ein ~ in Anführungszeichen funktioniert nicht). Auf Windows enthalten sie Backslashes und oft Leerzeichen, was ohne Anführungszeichen bricht.

Auf Windows (prüfen mit uname -s: es beginnt mit MINGW oder MSYS in Claude Codes Shell auf Windows), überspringe die Schritte 1 und 2 unten und mache stattdessen dies:

• Node und ffmpeg: Überprüfe node --version (22 oder neuer) und ffmpeg -version. Installiere Fehlendes mit winget install --id OpenJS.NodeJS.LTS -e und winget install --id Gyan.FFmpeg -e. Windows zeigt möglicherweise ein Fenster „Möchten Sie zulassen, dass diese App Änderungen vornimmt?“: das Mitglied klickt auf Ja. Falls ein Tool direkt nach der Installation noch nicht gefunden wird, sucht die Engine auch im eigenen Winget-Ordner; wenn ENGINE doctor es weiterhin rot anzeigt, bitte das Mitglied, Claude zu schließen und erneut zu öffnen, dann erneut prüfen.
• Whisper (der Transkribierer): Finde den Windows-Download mit curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest und nimm das Asset mit dem genauen Namen whisper-bin-x64.zip. Falls kein Asset diesen Namen hat, stoppe und teile dem Mitglied mit: „Das Windows-Setup benötigt ein Update für den neuesten Whisper-Download. Sam wurde informiert.“ Sonst mkdir -p "HOME/tools/whisper", curl -L --fail -o "HOME/tools/whisper.zip" <die browser_download_url dieses Assets>, /c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper" (Windows' eigenes tar liest Zip-Dateien; das tar, das mit Git Bash kommt, tut dies nicht), dann lösche die Zip. Überprüfe, dass whisper-cli.exe gelandet ist: ls "HOME/tools/whisper" "HOME/tools/whisper/Release". Falls es in keinem der beiden Ordner ist, stoppe und teile dem Mitglied dieselbe Nachricht mit: „Das Windows-Setup benötigt ein Update für den neuesten Whisper-Download. Sam wurde informiert.“ ENGINE doctor sollte nun whisper-cli grün anzeigen.
• Dann fahre mit Schritt 3 unten fort. In ENGINE doctor sagt die optionale Zeile „– person cutout“ „nur auf einem Mac für jetzt“: Teile dem Mitglied einmal mit: „Die zwei Haken-Looks, die Typ hinter deinen Kopf setzen, sind vorerst nur auf dem Mac verfügbar. Die anderen vier funktionieren.“ Biete keine Lösung dafür an.

1. Homebrew (der Tool-Installer): Überprüfe which brew, dann /opt/homebrew/bin/brew und /usr/local/bin/brew. Falls keines existiert, installiert das Mitglied es mit einem normalen Mac-Installer, ohne Terminal: Sende es zu https://github.com/Homebrew/brew/releases/latest, lass es die Datei herunterladen, die auf .pkg endet, doppelklicke darauf und klicke durch (es fragt nach dem Mac-Passwort im üblichen Mac-Fenster; du tippst oder fragst nie danach). Warte, bis es sagt, dass es fertig ist, dann überprüfe erneut. Falls brew immer noch nicht beim Namen gefunden wird, rufe es mit seinem vollständigen Pfad auf (/opt/homebrew/bin/brew) für den nächsten Schritt.
2. Tools: brew install node ffmpeg whisper-cpp (überspringe, was bereits vorhanden ist). Dann ENGINE doctor. Korrigiere alles Rote mit dem Hinweis fix.
   • Eine Zeile, die mit – beginnt, ist optional. – person cutout bedeutet, dass zwei Hook-Karten-Looks (Typ hinter deinem Kopf) auf diesem Mac deaktiviert sind; alles andere funktioniert. Biete den Fix einmal an: „Möchtest du die zwei Hinter-dem-Kopf-Hook-Looks? Führe xcode-select --install im Terminal aus, klicke auf Installieren, dann sage ‚nochmal prüfen‘.“ Blockiere die Einrichtung nicht darauf.
3. Renderer-Browser + Sprachmodell (Einmal-Downloads, etwa 700MB): Führe npx -y [email protected] browser ensure aus. Stelle dann sicher, dass das Sprachmodell vorhanden ist: Überprüfe ~/.cache/hyperframes/whisper/models/ggml-small.en.bin oder HOME/models/ggml-small.en.bin. Falls keines existiert, lade es herunter: 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. Arbeitsbereich: ENGINE init-home. Es gibt den Reels-Ordner aus und überschreibt niemals vorhandene Dateien.
5. Die Grundlagen, eine Frage nach der anderen, gespeichert in HOME/brand-kit.json (behalte jeden anderen Schlüssel, der bereits in der Datei ist):
   • Instagram-Handle → handle
   • Standard-Reel-Länge in Sekunden (Standard 40) → default_target_seconds
6. Vokabular: Frage nach Namen, Tools und Markenwörtern, die sie oft sagen (ihr Geschäftsname, Produkte, Apps). Schreibe sie zeilenweise in HOME/vocabulary.txt, damit die Transkription sie richtig schreibt.
7. Ihr Stil. Führe das Stil-Interview in ../reel-style/references/style-interview.md durch: Es öffnet die Beschriftungsauswahlseite, und was sie dort auswählen, wird ihr Standardstil. Frage nicht nach einem Beispiel-Reel oder einem Link. Überspringe den Benennungsschritt des Interviews: Der Stil ist immer main (schreibe es direkt nach HOME/styles/main.json, kein draft). Biete keinen zweiten Stil an; sie können später einen mit /reels-engine:reel-style hinzufügen.
8. Beende mit: „Du bist eingerichtet. Ziehe 1-4 Clips in den Chat und sage ‚new reel‘ (oder tippe /reels-engine:reel).“

Erneutes Ausführen ist sicher: Überspringe, was bereits erledigt ist. Frage die Grundlagen nur erneut, wenn sie sie ändern möchten, und sende Stiländerungen an /reels-engine:reel-style.