hyperframe — Router zu HeyGen HyperFrames
HyperFrames (Apache-2.0, github.com/heygen-com/hyperframes) verwandelt HTML/CSS/JS-Kompositionen in deterministische MP4s: der Renderer sucht jeden Frame in Headless Chrome und kodiert ihn mit FFmpeg. Diese Fähigkeit ist ein DÜNNER Router – das gesamte Wissen lebt im geklonten Repository und seinen eigenen 20 Agent-Skills; niemals die Upstream-Dokumentation hier duplizieren.
Lokale Pfade
Auflösung: HYPERFRAMES_HOME Umgebungsvariable → ~/.jstack/config.env → Standard unten.
| Was | Wo |
|---|---|
| Geklontes Repository (kanonische lokale Kopie) | ~/.jstack/vendor/hyperframes |
| Upstream-Router-Skill (Zuerst lesen FÜR JEDE mach-mir-ein-Video-Anfrage) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
Seine 20 Agent-Skills (auch installiert in ~/.claude/skills/ + ~/.agents/skills/ durch hyperframes init) | ~/.jstack/vendor/hyperframes/skills/ |
Block-/Komponenten-Registry (70+ Blöcke: Lower-Thirds lt-*, code-*, logo-outro, glitch, data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| Dokumentationsquellen (Schnellstart, Konzepte, Referenz, Katalog) | ~/.jstack/vendor/hyperframes/docs/ |
| Online: Dokumentation + Block-Katalog | hyperframes.heygen.com (Schnellstart/Dokumente/Katalog), hyperframes.dev (Playground + Designvorlagen) |
Installation / Zustandsprüfung
Voraussetzungen: Node 22+ und FFmpeg im PATH (auf diesem Rechner verifiziert, CLI v0.7.48).
npx --yes hyperframes doctor # Umgebungs-Check
npx --yes hyperframes init my-video # Projekt anlegen (installiert/aktualisiert auch seine Agent-Skills)
cd my-video && npm run render # → renders/*.mp4
init erstellt index.html + hyperframes.json und fixiert die CLI-Version in package.json
Scripts (dev/check/render/publish). Klon aktualisieren mit
git -C ~/.jstack/vendor/hyperframes pull.
Dispatch-Tabelle
Leiten Sie die Absicht weiter, dann ÖFFNEN/SIE das Upstream-Ziel aus – improvisieren Sie keinen Workflow.
| Absicht | Gehe zu |
|---|---|
| Jede „Mach mir ein Video/Animation“-Anfrage (Einstiegspunkt) | Lesen Sie das /hyperframes Router-Skill: ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md – es wählt den Workflow aus |
| Animierter Hook-Text / kinetische Titel / Stat-Hit / Logo-Sting / End-Card / Lower-Third (kurz, unerzählt, designgetrieben) | /motion-graphics Workflow: skills/motion-graphics/ im Klon; Lower-Third-Blöcke = Registry lt-*, End-Card = logo-outro |
| Kinetische Untertitel auf einem vorhandenen Talking-Head-Video | /embedded-captions Workflow: skills/embedded-captions/ (Footage unberührt, Untertitel darüber gerendert) |
HTML→MP4-Komposition erstellen oder bearbeiten (der data-* Timing-Vertrag, Clips, Tracks) | /hyperframes-core dann /hyperframes-animation: skills/hyperframes-core/, skills/hyperframes-animation/ |
| Blöcke und Komponenten durchsuchen / installieren | Registry-Verzeichnisse registry/{blocks,components} oder hyperframes.heygen.com/catalog; installieren + verdrahten über /hyperframes-registry und npx hyperframes add [block] |
| Rendern / Vorschau / Linten / Validieren einer Komposition | /hyperframes-cli: npx hyperframes preview, npx hyperframes lint && npx hyperframes validate, npx hyperframes render, npx hyperframes doctor |
| BGM / SFX / Voiceover / Icons / Hintergrundentfernung für eine Komposition | /media-use: skills/media-use/ |
| Deck / Slideshow, Produkt-Promo, PR-to-Video, musik-synchronisiert, Website-Tour, Remotion-Port | Das passende Workflow-Skill in skills/ (siehe Cheat-Sheet des /hyperframes Routers) |
Wann NICHT verwenden (StayFrame rote Linie)
StayFrames Feed-Ästhetik-Nordstern (ADR 0002, editorial-minimal – „Würde das unbemerkt im Aman/Soneva-Grid sitzen?“) macht starke Motion-Graphics-Stile OFF-BRAND: Hormozi-artige kinetische Untertitel, Glitch/VFX-Blöcke, News-Ticker, Liquid-Glass-Widgets. Für StayFrame-Reels HyperFrames nur für SUBTILE minimale Überlagerungen verwenden, und:
- Statische Textüberlagerungen bleiben auf der bestehenden Spur – Headless-Chrome + ffmpeg via
/jstack-sf-caption. Nicht auf HyperFrames migrieren. - Generative Videos (i2v/t2v) sind nie HyperFrames – das ist
/vidgen.
Fallstricke
hyperframes inithat kein--yesFlag (Fehler bei unbekannten Flags); es ist bereits nicht-interaktiv.initNebeneffekt: Installiert/aktualisiert HyperFrames eigene Kern-Skills in~/.claude/skills/und~/.agents/skills/– erwartet, hält den Upstream-Router aktuell.- Eigenständige Skill-Installation:
npx skills add heygen-com/hyperframes --full-depth–--full-depthverwenden, sonst erhält man ein veraltetes skills.sh Registry-Blob, das hintermainhinterherhinkt. - Telemetrie ist standardmäßig aktiviert; deaktivieren mit
hyperframes telemetry disable. - Render-Ausgabe landet in
renders/[project]_[timestamp].mp4im Projektverzeichnis.
Nächste Skills
| Nächstes | Wann |
|---|---|
/vidgen | Die Komposition benötigt generiertes Footage (i2v/t2v-Clips) als Quellmaterial – Videogenerierung wird immer dorthin weitergeleitet, nie direkt zu einem Backend. |
/jstack-sf-caption | Ein StayFrame-Reel benötigt einfache statische Textüberlagerungen – diese Spur bleibt bei Headless-Chrome + ffmpeg, nicht bei HyperFrames. |
/jstack-sf-trim-stitch | Ein gerenderter HyperFrames-Overlay/End-Card muss in ein StayFrame-Reel eingebaut werden. |