heygen-com/hyperframes

GITHUB中文整理

主语言 TypeScript · 74,494 星 · Apache-2.0 · 创建于 2026-03-10

视频渲染HTML 合成开源框架AI 代理命令行 本月第 1 名
打开 GitHub 仓库

HyperFrames 是一个开源框架,把 HTML、CSS、媒体和可定位动画转换成确定性的 MP4 视频,可通过命令行在本地使用,也可被 AI 编程助手调用。

Stars 74,494 累计 star,越多说明被认可得越广
Watching 183 订阅该仓库变动的人数
Forks 6,267 被派生出去的仓库数
Issues 396 当前开放的 Issue 数
语言 TypeScript GitHub 自动判定的主语言
许可证 Apache-2.0 开源协议,用之前先确认能不能商用
24h 增长 — 数据积累中
7 日增长 — 数据积累中
30 日增长 — 数据积累中

仓库健康度

5 个维度
只看客观信号,不构成安全性结论
维护活跃度 数据完整
2026-10-22 09:10 最近推送

最近推送 2026-10-22 09:10(6 天前),属于活跃维护

社区响应 数据完整
396 开放 Issue

开放 Issue 396 个 · Fork 6,267 个

增长趋势 证据不足
— 7 日新增

star 记录还不够天数,增量算不出来

项目规范 数据完整
Apache-2.0 许可证

许可证 Apache-2.0 · 12 个 topics · 开了 Wiki

版本发布 证据不足
— 发布次数

这一项暂无数据,不代表项目没有发布

「证据不足」表示这项数据暂时没有取到,不能读成「项目有问题」;「部分数据」表示只拿到一部分信号。版本发布要额外调 Releases 接口,下一版补。

Star 趋势

6 天记录
最近 90 天站内记录的星数
74,494当前 Star +4,042首尾差值 2026-10-23最早记录 2026-10-28最近记录

横轴 2026-10-23 → 2026-10-28,纵轴按这段时间的最小/最大值拉伸。趋势来自站内每天记录一次的星数,页面打开时不会实时请求 GitHub。

它解决什么问题

据 README 归纳
没有它会怎样

做视频往往要依赖专有时间线工具或前端框架,格式封闭、结果不稳定,难以在 CI 中回归测试和自动批量生成。没有它,就只能手工操作图形软件或拼凑录屏方案,重复渲染结果不一致,AI 代理也无法直接产出可复现的视频。

核心能力

7 条
归纳自 README,不是功能列表照抄
  1. 1用 HTML 文件加数据属性定义画面、时间与轨道
  2. 2在同一份输入下逐帧定位渲染,输出结果保持一致
  3. 3无需构建步骤,浏览器中直接预览合成页面
  4. 4接入 GSAP、CSS、Lottie、Three.js、Anime.js、WAAPI 等动画运行时
  5. 5提供命令行完成脚手架、预览、检查、渲染等操作
  6. 6渲染在无头 Chrome 中逐帧定位,用 FFmpeg 编码并混音
  7. 7附带面向编程代理的技能说明与可复用组件目录

项目画像

6 个角度
决定要不要用之前,先看这六条

项目定位

HyperFrames 是一个开源框架,把 HTML、CSS、媒体和可定位动画转换成确定性的 MP4 视频,可通过命令行在本地使用,也可被 AI 编程助手调用。

适合谁

适合希望以代码方式生产视频的开发者,以及用 Claude Code、Codex、Cursor、Gemini CLI 等编程助手自动生成视频的人;也适合需要把渲染接入 CI 或自动化流程的团队。

典型场景

在浏览器里预览 HTML 合成画面,确认无误后再本地或 Docker 中渲染成 MP4。;让编程助手按技能流程规划视频、编写 HTML、接好动画并完成检查和渲染。;把逐帧确定性渲染接入 CI,对视频输出做回归测试或批量自动生成。;复用组件目录中的转场、字幕、图表、地图等模块快速搭建视频内容。

部署难度

通过 npx 即可使用命令行工具完成项目搭建、预览和渲染;本地渲染需具备无头 Chrome 与 FFmpeg 环境,也可改用 Docker 或部署到 AWS Lambda 的渲染方案。

风险限制

采用 Apache 2.0 许可证;动画效果取决于所选适配器;逐帧渲染依赖无头 Chrome 与 FFmpeg;代理相关能力需要兼容技能机制的编程助手。

最近维护

最近一次推送是 2026-10-22 09:10。 实现方式:画面写成 HTML,用数据属性标注时间与轨道,动画由可定位的适配器驱动。渲染器在无头 Chrome 中逐帧定位并截图,再交给 FFmpeg 编码成视频并混合音频,因此相同输入始终得到相同输出。

README 原文细节

3 个板块
项目自己写的功能与用法,原文照录

环境与依赖跑它之前要准备什么

HyperFrames Stack

HyperFrames is the open-source rendering engine, plus a growing set of tools around HTML-native video creation.

  • CLI — Available — Scaffold, preview, lint, inspect, and render local video projects
  • Core / Engine / Producer — Available — Parse compositions, drive headless Chrome, encode video, and mix audio
  • Catalog — Available — Reusable blocks and components for transitions, overlays, captions, charts, maps, and effects
  • Agent skills — Available — Teach coding agents the video-production patterns that generic web docs miss
  • Studio — Available, evolving — Browser surface for previewing and editing compositions
  • AWS Lambda rendering — Available — Deploy a distributed render stack and drive renders from your laptop or CI
  • hyperframes.dev — Available — Community playground for previewing, iterating, sharing, and rendering HTML-native video projects
  • frame.md — Available — Invert your design system for the camera — a DESIGN.md superset an agent can compose video from

实现原理它内部是怎么做的

How It Works

Define a video as HTML. Add data attributes for timing and tracks. Use GSAP, CSS, Lottie, Three.js, Anime.js, WAAPI, or your own frame adapter for seekable animation.

Preview instantly in the browser. Render locally or in Docker. The renderer seeks each frame in headless Chrome and encodes the result with FFmpeg, so the same input produces the same video.

其它说明README 里剩下的内容

Core set

  • /hyperframes — Read first for any request to make, edit, animate or render a video, motion graphic, captions or overlays with HyperFrames (HTML rendered to video). Holds the render contract and the wo
  • /hyperframes-cli — The HyperFrames CLI by job — scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history — plus reading its JSON and recove
  • /hyperframes-registry — About 450 ready-made blocks and components installed as editable source — transitions, overlays, titles, kinetic type, captions, charts, maps, 3D, camera moves. Use before hand
  • /media-use — Get or make any media for a video — music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks — with HeyGen or free

概述

HyperFrames is an open-source framework for turning HTML, CSS, media, and seekable animations into deterministic MP4 videos. Use it locally with the CLI, from AI coding agents with skills, or as the rendering core behind hosted authoring workflows.

Using Claude Code, Codex, Cursor, or another coding agent? Run npx hyperframes skills update once, then ask your agent to make a video.

With an AI coding agent

Enable auto-update for the hyperframes marketplace in /plugin → Marketplaces, then use /hyperframes:hyperframes. See the plugin guide for Copilot, VS Code, Cursor, Gemini CLI, updates, and migration.

The skills teach agents the HyperFrames production loop: plan the video, write valid HTML, wire seekable animations, add media, lint, preview, and render. They work with Claude Code, Codex, Cursor, Gemini CLI, IBM Bob, and other coding agents that support skills.

关于 hyperframes 的常见问题

6 个问题
答案来自 README 归纳与 GitHub 实时数据
hyperframes 是做什么的?

HyperFrames 是一个开源框架,把 HTML、CSS、媒体和可定位动画转换成确定性的 MP4 视频,可通过命令行在本地使用,也可被 AI 编程助手调用。 做视频往往要依赖专有时间线工具或前端框架,格式封闭、结果不稳定,难以在 CI 中回归测试和自动批量生成。没有它,就只能手工操作图形软件或拼凑录屏方案,重复渲染结果不一致,AI 代理也无法直接产出可复现的视频。

hyperframes 有哪些功能?

核心能力:用 HTML 文件加数据属性定义画面、时间与轨道;在同一份输入下逐帧定位渲染,输出结果保持一致;无需构建步骤,浏览器中直接预览合成页面;接入 GSAP、CSS、Lottie、Three.js、Anime.js、WAAPI 等动画运行时;提供命令行完成脚手架、预览、检查、渲染等操作;渲染在无头 Chrome 中逐帧定位,用 FFmpeg 编码并混音;附带面向编程代理的技能说明与可复用组件目录。

hyperframes 适合谁用?

适合希望以代码方式生产视频的开发者,以及用 Claude Code、Codex、Cursor、Gemini CLI 等编程助手自动生成视频的人;也适合需要把渲染接入 CI 或自动化流程的团队。

hyperframes 是怎么工作的?

画面写成 HTML,用数据属性标注时间与轨道,动画由可定位的适配器驱动。渲染器在无头 Chrome 中逐帧定位并截图,再交给 FFmpeg 编码成视频并混合音频,因此相同输入始终得到相同输出。

用 hyperframes 有什么门槛或限制?

采用 Apache 2.0 许可证;动画效果取决于所选适配器;逐帧渲染依赖无头 Chrome 与 FFmpeg;代理相关能力需要兼容技能机制的编程助手。

hyperframes 现在还在维护吗?数据怎么样?

目前 74,494 星,6,267 个 Fork,主语言 TypeScript,创建于 2026-03-10,最近一次推送 2026-10-22 09:10,许可证 Apache-2.0。星数、Fork、推送时间都是 GitHub 返回的实时数据,「最近推送」离现在越近说明越活跃;长期不动要留意是否已停止维护。

这些内容来自哪

读法说明
中文整理据 README 归纳,数据取自 GitHub
中文说明据项目 README 归纳只写 README 能确认的内容,不替作者补功能与数字
关键数据与 GitHub 页面一致星数、Fork、语言与时间都不做二次加工
数据日期2026-10-23 17:48星数与介绍这份数据是哪一天的

项目数据取自 GitHub 官方接口与项目 README;星数、Fork、语言与时间以 GitHub 页面为准,档案更新于 2026-10-23 17:48。