heygen-com/hyperframes

项目概览

该项目通过驱动无头 Chrome 逐帧寻址并使用 FFmpeg 编码，在相同输入下产出确定性 MP4，适合直接接入 CI 流水线。

项目类型

视频技术 · 基础设施

应用场景

文档办公

部署方式

查看项目说明

License

Apache-2.0

适合谁

• 需要为自动化流水线和 AI 智能体提供确定性 MP4 视频生成能力的开发者。

核心能力

• 解析 HTML 组合，驱动无头 Chrome 寻址每一帧，并使用 FFmpeg 对结果进行编码，从而生成确定性的 MP4 视频。
• 内置 19 项技能，旨在教会编码智能体掌握 hyperframes 的生产循环，包括计划、编写 HTML、接入动画、代码检查、预览和渲染。
• 提供一个基于浏览器的用户界面，用于预览和编辑组合内容。需注意该浏览器界面目前仍标记为正在演进中。
• 提供 SDK 和部署平台，用于运行分布式渲染堆栈，支持从笔记本电脑或 CI 驱动渲染。

限制与风险

• 在本地手动使用时，必须已安装 Node.js 22+ 和 FFmpeg。
• 代码仓库使用 Git LFS 来存储体积庞大的黄金回归测试基准文件，克隆时需配置 LFS。
• 作为预览和编辑界面的浏览器端 Studio UI 目前仍被标记为演进中状态，存在变动风险。

如何开始

• 首先安装 Node.js 22+ 和 FFmpeg；随后通过单条 npx 命令脚手架创建项目；最后运行预览命令即可查看效果。上手难度较低。

核验依据

• README: HyperFrames is an open-source framework for turning HTML, CSS, media, and seekable animations into deterministic MP4 videos.
• README: The skills teach agents the HyperFrames production loop: plan the video, write valid HTML, wire seekable animations, add media, lint, preview, and render.
• README: HyperFrames ships 19 skills agents load on demand.
• README: plus HeyGen-hosted cloud rendering (`cloud render`) and AWS Lambda rendering (`lambda deploy / render / progress`).
• README: Requirements: Node.js 22+, FFmpeg

内容核验时间：