Communitygithub.com

HyperFrames CLI

HyperFrames CLI-Werkzeug — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Verwenden Sie es beim Erstellen eines Projekts, beim Linten oder Validieren von Kompositionen, beim Vorschaum im Studio, beim Rendern in Video, beim Transkribieren von Audio, beim Generieren von TTS oder zur Fehlerbehebung der HyperFrames-Umgebung.

Was ist HyperFrames CLI?

Der HyperFrames CLI-Skill bietet alle wichtigen Befehle für die Arbeit mit HyperFrames Video-Kompositionen. Er wird über `npx hyperframes` ausgeführt und erfordert Node.js >= 22 sowie FFmpeg. Der Skill umfasst Befehle zum Erstellen (`init`), Linten (`lint`), Vorschaum (`preview`), Rendern (`render`), Transkribieren (`transcribe`), Text-to-Speech (`tts`) und zur Fehlerbehebung (`doctor`, `browser`, `info`, `upgrade`). Er ist für CLI, CI/CD und KI-Agenten optimiert – besonders nützlich, um Projekte schnell zu skalieren, Audio-Transkriptionen zu erstellen und Render-Workflows zu automatisieren. Der Befehl `init` erstellt automatisch die richtige Dateistruktur und installiert KI-Coding-Skills, während `doctor` hilft, häufige Probleme wie fehlende Abhängigkeiten zu erkennen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-cli

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht HyperFrames CLI?

Alles läuft über npx hyperframes. Erfordert Node.js >= 22 und FFmpeg.

Arbeitsablauf

  1. Gerüst erstellen — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition verfassen (siehe Skill hyperframes)
  3. Linten — npx hyperframes lint
  4. Vorschau — npx hyperframes preview
  5. Rendern — npx hyperframes render

Vor der Vorschau linten – erkennt fehlende data-composition-id, überlappende Spuren, nicht registrierte Zeitachsen.

Gerüst erstellen

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # ein Beispiel auswählen
npx hyperframes init my-video --video clip.mp4        # mit Videodatei
npx hyperframes init my-video --audio track.mp3       # mit Audiodatei
npx hyperframes init my-video --non-interactive       # Eingabeaufforderungen überspringen (CI/Agenten)

Vorlagen: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init erstellt die richtige Dateistruktur, kopiert Medien, transkribiert Audio mit Whisper und installiert KI-Coding-Skills. Verwenden Sie es, anstatt Dateien von Hand zu erstellen.

Linten

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./my-project     # spezifisches Projekt
npx hyperframes lint --verbose        # Ergebnisse auf Info-Ebene
npx hyperframes lint --json           # maschinenlesbar

Lintet index.html und alle Dateien in compositions/. Meldet Fehler (müssen behoben werden), Warnungen (sollten behoben werden) und Informationen (mit --verbose).

Vorschau

npx hyperframes preview                   # aktuelles Verzeichnis bereitstellen
npx hyperframes preview --port 4567       # benutzerdefinierter Port (Standard 3002)

Lädt bei Dateiänderungen neu. Öffnet das Studio automatisch im Browser.

Rendern

npx hyperframes render                                # Standard MP4
npx hyperframes render --output final.mp4             # benannte Ausgabe
npx hyperframes render --quality draft                # schnelle Iteration
npx hyperframes render --fps 60 --quality high        # finale Auslieferung
npx hyperframes render --format webm                  # transparentes WebM
npx hyperframes render --docker                       # byte-identisch
FlagOptionenStandardHinweise
--outputPfadrenders/name_timestamp.mp4Ausgabepfad
--fps24, 30, 603060fps verdoppelt Renderzeit
--qualitydraft, standard, highstandarddraft für Iteration
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder startet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Kodierung
--strictFlagausBei Lint-Fehlern abbrechen
--strict-allFlagausBei Fehlern UND Warnungen abbrechen

Qualitätshinweise: draft während der Iteration, standard für die Überprüfung, high für die finale Auslieferung.

Transkription

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # vorhandene importieren
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Text-to-Speech

npx hyperframes tts "Text hier" --voice af_nova --output ausgabe.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # alle Stimmen anzeigen

Fehlerbehebung

npx hyperframes doctor       # Umgebung prüfen (Chrome, FFmpeg, Node, Arbeitsspeicher)
npx hyperframes browser      # gebündelten Chrome verwalten
npx hyperframes info         # Versions- und Umgebungsdetails
npx hyperframes upgrade      # nach Updates suchen

Führen Sie zuerst doctor aus, wenn das Rendern fehlschlägt. Häufige Probleme: fehlendes FFmpeg, fehlendes Chrome, zu wenig Arbeitsspeicher.

Sonstiges

npx hyperframes compositions   # Kompositionen im Projekt auflisten
npx hyperframes docs           # Dokumentation öffnen
npx hyperframes benchmark .    # Render-Leistung benchmarken

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Verwandte Skills