notasimrazzaq/AI-Video-Editor

Überprüft oder repariert die Video-Bearbeitungstoolchain auf diesem Windows-PC (Node 22+, FFmpeg, Deepgram-Schlüssel, Chrome, HyperFrames-Skills). Verwenden, wenn Transkription oder Rendering fehlschlägt, ein neuer PC eingerichtet werden muss, .setup-ok fehlt oder der Benutzer nach einem Update von HyperFrames fragt.

Was ist AI-Video-Editor?

Dieses Skill führt eine umfassende Überprüfung und Reparatur der Video-Bearbeitungstoolchain auf einem Windows-PC durch. Es stellt sicher, dass alle benötigten Komponenten wie Node.js 22+, FFmpeg, ein gültiger Deepgram-API-Schlüssel, Chrome und die HyperFrames-Skills installiert und korrekt konfiguriert sind. Das Skill verwendet ein unbeaufsichtigtes PowerShell-Skript (`tools/setup.ps1`), das alles automatisch installiert oder repariert und bei Erfolg eine `.setup-ok`-Datei erstellt. Falls etwas nicht automatisch behoben werden kann, gibt es eine klare Fehlermeldung mit Anleitung zur manuellen Behebung aus. Es wird auf Plattformen wie Claude Code, Cursor, Codex und ähnlichen KI-Agenten-Frameworks eingesetzt, die eine zuverlässige Video-Bearbeitungsumgebung benötigen. Das Skill vermeidet bewusst aufwendige lokale Modelle wie whisper.cpp, da diese auf typischen PCs langsam und laut sind, und setzt stattdessen auf Deepgram für Transkription und Sprachunterstützung.

Funktioniert mit✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/notasimrazzaq/AI-Video-Editor/tree/HEAD/.agents/skills/mg-setup-check

Dokumentation

Setup-Überprüfung (Windows)

Alles installieren oder reparieren (unbeaufsichtigt, kann problemlos erneut ausgeführt werden, schreibt .setup-ok bei Erfolg):

powershell -NoProfile -ExecutionPolicy Bypass -File tools/setup.ps1

Es gibt SETUP FAILED: <Grund> mit der entsprechenden Behebung aus, wenn etwas nicht automatisch erledigt werden kann.

Bekannte korrekte Konfiguration:

Tool	Pfad
Node.js 22+	winget `OpenJS.NodeJS.LTS` → `C:\Program Files\nodejs`
FFmpeg / FFprobe	winget `Gyan.FFmpeg`
Transkription / KI-Sprachausgabe	Deepgram API via `tools/transcribe-deepgram.ps1`, Schlüssel in Benutzer-Umgebungsvariable `DEEPGRAM_API_KEY`
Chrome	Systeminstallation oder private Kopie von `npx --yes hyperframes browser ensure`
HyperFrames-Skills	`%USERPROFILE%\.agents\skills` (+ `.claude\skills`)

whisper.cpp oder lokale Transkriptionsmodelle nicht installieren (langsam und laut auf typischen PCs).

Überprüfung

npx -y hyperframes doctor

Docker, Kokoro (TTS), MusicGen und whisper-cpp werden hier nicht benötigt – ignorieren Sie sie.

Häufige Behebungen

Deepgram-Schlüssel: Der Benutzer führt powershell -NoProfile -ExecutionPolicy Bypass -File tools/set-deepgram-key.ps1 selbst aus (niemals in den Chat einfügen). Skripte lesen den Wert aus dem Benutzerbereich auch in alten Terminals.
node / ffmpeg nicht gefunden direkt nach Setup: PATH im Terminal aktualisieren ($env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')) oder den Editor neu starten.
„Ausführung von Skripten ist deaktiviert“: Skripte immer über powershell -NoProfile -ExecutionPolicy Bypass -File ... aufrufen.
Deepgram 401: Schlüssel falsch/abgelaufen – den Benutzer bitten, ihn erneut zu setzen. 402/429: Guthaben aufgebraucht / Ratenbegrenzung erreicht.
Skills/CLI aktualisieren: npx -y hyperframes skills update, npx -y hyperframes upgrade.
Alles, was Administratorrechte benötigt: Dem Benutzer den genauen Befehl zur Ausführung in einem Administrator-Terminal geben.