Communitygithub.com

nateherkai/hyperframes-student-kit

HyperFrames CLI 工具 — 支持 hyperframes init、lint、preview、render、transcribe、tts、doctor、browser、info、upgrade、compositions、docs、benchmark。适用于搭建项目、检查或验证组合、在工作室中预览、渲染为视频、转录音频、生成 TTS 或排查 HyperFrames 环境问题。

hyperframes-student-kit 是什么?

HyperFrames CLI 是一个面向视频创作工作流的开发者工具,提供从搭建、编写、预览到最终渲染的完整流水线。其核心价值在于简化基于 HTML 的动态视频组合(composition)的创建与迭代。支持通过 `init` 命令快速脚手架项目、`lint` 命令检查组合中的常见错误(如缺失 data-composition-id、重叠轨道),以及通过 `preview` 命令提供自动热重载的实时预览。渲染模块支持多种输出格式(MP4、WebM)、不同质量等级(draft/standard/high)、帧率和 GPU 加速,同时提供 Docker 模式确保字节一致性。此外,还集成了 Whisper 音频转录、文本转语音(TTS)、环境诊断(doctor)以及性能基准测试等功能。该工具需要 Node.js >= 22 和 FFmpeg,兼容 Claude Code、Cursor 等支持 CLI 调用的 AI 智能体平台,是视频自动化与 AI 辅助创作场景下的理想选择。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HyperFrames CLI

一切通过 npx hyperframes 运行。需要 Node.js >= 22 和 FFmpeg。

工作流程

  1. 搭框架 — npx hyperframes init my-video
  2. 编写 — 编写 HTML 组合(参见 hyperframes 技能)
  3. 检查 — npx hyperframes lint
  4. 预览 — npx hyperframes preview
  5. 渲染 — npx hyperframes render

预览前先检查 — 可捕获缺失的 data-composition-id、重叠轨道、未注册的时间线。

脚手架搭建

npx hyperframes init my-video                        # 交互式向导
npx hyperframes init my-video --example warm-grain   # 选择一个示例
npx hyperframes init my-video --video clip.mp4        # 配合视频文件
npx hyperframes init my-video --audio track.mp3       # 配合音频文件
npx hyperframes init my-video --non-interactive       # 跳过提示(CI/智能体)

模板:blank、warm-grain、play-mode、swiss-grid、vignelli、decision-tree、kinetic-type、product-promo、nyt-graph。

init 会创建正确的文件结构,复制媒体文件,使用 Whisper 转录音频,并安装 AI 编写技能。请用它代替手动创建文件。

代码检查

npx hyperframes lint                  # 当前目录
npx hyperframes lint ./my-project     # 指定项目
npx hyperframes lint --verbose        # 信息级别发现
npx hyperframes lint --json           # 机器可读

检查 index.html 和 compositions/ 目录下的所有文件。报告错误(必须修复)、警告(应修复)和信息(配合 --verbose)。

预览

npx hyperframes preview                   # 提供当前目录服务
npx hyperframes preview --port 4567       # 自定义端口(默认 3002)

文件更改时自动热重载。自动在浏览器中打开工作室。

渲染

npx hyperframes render                                # 标准 MP4
npx hyperframes render --output final.mp4             # 指定输出文件名
npx hyperframes render --quality draft                # 快速迭代
npx hyperframes render --fps 60 --quality high        # 最终交付
npx hyperframes render --format webm                  # 透明 WebM
npx hyperframes render --docker                       # 字节级一致
标志选项默认值说明
--output路径renders/名称_时间戳.mp4输出路径
--fps24, 30, 603060fps 渲染时间加倍
--qualitydraft, standard, highstandarddraft 用于迭代
--formatmp4, webmmp4WebM 支持透明度
--workers1-8 或 autoauto每个 worker 启动一个 Chrome
--docker标志off可复现的输出
--gpu标志offGPU 加速编码
--strict标志off检查错误时失败
--strict-all标志off错误和警告时均失败

质量指导: 迭代时使用 draft,审阅时使用 standard,最终交付时使用 high。

转录

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 导入现有字幕
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

文本转语音

npx hyperframes tts "这里写入文本" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # 列出所有语音

故障排除

npx hyperframes doctor       # 检查环境(Chrome、FFmpeg、Node、内存)
 npx hyperframes browser      # 管理绑定的 Chrome
npx hyperframes info         # 版本和环境详情
npx hyperframes upgrade      # 检查更新

如果渲染失败,先运行 doctor。常见问题:缺少 FFmpeg、缺少 Chrome、内存不足。

其他

npx hyperframes compositions   # 列出项目中的组合
 npx hyperframes docs           # 打开文档
npx hyperframes benchmark .    # 基准测试渲染性能

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.

相关技能