andyluu98/VideoMotion

Überprüft und installiert alle Abhängigkeiten für VideoMotion (Node.js, ffmpeg, HyperFrames, Python-Umgebung, VieNeu-Stimme, Whisper). Wird verwendet, wenn Benutzer das Plugin neu installieren, "/vm-cai-dat", "Video einrichten" oder "Maschine auf Videoerstellung prüfen" eingeben, oder wenn ein Schritt bei der Videoerstellung meldet, dass ein Tool fehlt.

Was ist VideoMotion?

Diese Fähigkeit (Skill) für KI-Agenten wie Claude Code, Cursor oder Codex automatisiert die Einrichtung und Überprüfung der VideoMotion-Plugin-Umgebung. Sie stellt sicher, dass alle erforderlichen Abhängigkeiten installiert und konfiguriert sind, darunter Node.js 22+, ffmpeg, ffprobe, HyperFrames, eine Python-Umgebung mit `vieneu`, `faster-whisper` und weiteren Paketen sowie die Modelle für VieNeu und Whisper large-v3-turbo. Die Fähigkeit nutzt gemeinsam genutzte Konfigurationen mit MotionFly unter `~/.motionfly`, sodass bestehende Installationen nicht erneut heruntergeladen werden müssen. Der Ablauf gliedert sich in drei Schritte: Überprüfung mit einem `doctor.py`-Skript, Installation der Python-Umgebung und Modelle (mit Benutzerbestätigung bei etwa 2–3 GB Download), und optionale Installation der HyperFrames-Skills für eine verbesserte Compositing-Unterstützung. Die Fähigkeit erkennt fehlende Komponenten, gibt klare Anweisungen für systemweite Installationen und protokolliert die Installation in `install.log`. Unterstützt wird die Ausführung auf Systemen mit und ohne NVIDIA-GPU, wobei die VieNeu-Stimme auf der CPU läuft.

Funktioniert mit✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/andyluu98/VideoMotion/tree/HEAD/skills/vm-cai-dat

Dokumentation

VideoMotion einrichten

VideoMotion teilt sich die Python-Umgebung und Modelle mit MotionFly unter ~/.motionfly: Wenn die Maschine bereits MotionFly ausgeführt hat, muss nichts erneut heruntergeladen werden.

Gemeinsame Variable für alle Skills des Plugins (ausgeführt in Bash):

VV="${CLAUDE_PLUGIN_ROOT}"
PY="$HOME/.motionfly/venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$HOME/.motionfly/venv/bin/python"
export PYTHONUTF8=1 HF_HUB_DISABLE_PROGRESS_BARS=1

Schritt 1. Überprüfung

Führen Sie mit einem beliebigen System-Python (3.10 oder höher) aus:

python "$VV/tools/setup/doctor.py"

Lesen Sie die Ergebnistabelle. Wenn in der obligatorischen Gruppe (Node.js 22+, ffmpeg, ffprobe, ffmpeg loudnorm, HyperFrames) Zeilen mit FEHLT angezeigt werden, informieren Sie den Benutzer, diese selbst zu installieren, und geben Sie den Link in der entsprechenden Spalte an. Installieren Sie keine Systemsoftware selbst.

Schritt 2. Python und Modelle installieren

Wenn "Python-Umgebung" oder "VieNeu-Stimme" fehlen, fragen Sie den Benutzer mit einer Bestätigungsfrage (es werden etwa 2 bis 3 GB heruntergeladen: Python-Pakete, VieNeu-Modell, Whisper large-v3-turbo-Modell) und führen Sie dann im Hintergrund aus:

python "$VV/tools/setup/doctor.py" --install > "$HOME/.motionfly/install.log" 2>&1

Dieser Befehl erstellt eine virtuelle Umgebung unter ~/.motionfly/venv (verwendet uv, falls verfügbar), installiert vieneu, faster-whisper, soundfile, numpy, scipy, lädt die Modelle herunter und repariert automatisch Symlink-Fehler des Hugging Face-Cache (ONNX Runtime meldet "External data path escapes model directory").

Schritt 3. HyperFrames-Skill für Claude

Wenn die Zeile "HyperFrames-Skill für Claude" als optional (noch nicht installiert) markiert ist, empfehlen Sie dem Benutzer, npx [email protected] skills auszuführen. Mit diesem Skill-Set wird das Composition beim Rendern standardisierter; ohne ihn funktioniert es dennoch dank der technischen Vereinbarung in agents/vm-canh.md.

Abschluss

Führen Sie Schritt 1 erneut aus. Wenn BEREIT angezeigt wird, informieren Sie den Benutzer, /videomotion mit der Videoanforderung einzugeben.

Hinweis für Maschinen ohne NVIDIA-Grafikkarte: Die VieNeu-Stimme läuft auf der CPU (etwa 0,4 Sekunden pro Sekunde Sprache auf einem Mittelklasse-Rechner), Hintergrundmusik wird entweder aus Benutzerdateien oder durch Code generiert.