HyperFrames Released: Deterministic MP4 Generation from HTML
HeyGen releases HyperFrames, an OSS that generates deterministic MP4s from HTML and CSS, supporting CLI and AI agent integration.
HeyGen has released HyperFrames, an open-source framework that generates deterministic MP4 videos from HTML and CSS. According to coverage of heygen-com on GitHub Trending, the framework takes HTML, CSS, media, and seekable animations as input and aims to produce reproducible MP4 output. It envisions three usage patterns: local CLI use, skill integration via AI coding agents, and embedding as the rendering core behind hosted authoring workflows.
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.
This article is based on GitHub Trending (All Rights Reserved) and relies on fair quotation under Article 32 of the Japanese Copyright Act.
The Idea of Writing HTML to Render Video
The core idea behind HyperFrames is to describe video with code. Conventional video production assumes timeline editing and dedicated software. In contrast, this framework defines video by writing HTML and CSS — the standards of web technology — and combining them with media elements and seekable animations. The authored HTML is rendered as-is and exported as MP4.
This approach has a low learning curve for web developers. Existing layout knowledge and style design can be reused. Component reuse and version control are also easy because everything is handled as text-based code. According to an article by Publickey, code-based video generation is considered highly compatible with reproducibility and automation, and HyperFrames pushes that direction even further.
The official onboarding paths — Quickstart, Showcase, Playground, Catalog, Docs, and Discord — support gradual learning from prototyping to production use. The intended flow is to check behavior in the Playground, refer to materials and patterns in the Catalog, and understand the specifications in the Docs.
Reproducibility Through Deterministic Rendering
The “deterministic” property advocated by HyperFrames is important for ensuring reproducibility in practice. Given the same HTML, CSS, media, and animation definitions, the same MP4 is generated regardless of execution environment or timing. Because rendering for each frame is controlled as seekable animations, behavior along the timeline is strictly defined.
This deterministic output works well with automation and testing. In CI-based video generation and iterative generation-and-verification loops by AI agents, minimal variation in output is advantageous from a quality-control perspective. Even when swapping media or dynamically replacing text, layout breakage or timing drift can be easily detected at the code level.
In addition, being HTML-based makes it possible to bring concepts of accessibility and responsive design into video production. Web assets such as style separation and cascade control are directly repurposed as expressive power for video.
Two Paths: CLI and Agent Integration
There are two main ways to use it. One is local use via CLI, and the other is use via AI coding agents. Both share the same production loop of writing HTML, then linting, previewing, and rendering.
Integration with AI agents uses a mechanism called skills. By giving natural-language instructions to an agent, a series of steps — planning the video, writing HTML, wiring animations, adding media, linting, previewing, and rendering — can be executed as a continuous flow. Supported agents include Claude Code, Cursor, Gemini CLI, and Codex. Similar to the trend seen in Desktop Commander MCP: Delegating Terminal Operations to AI, where development operations are delegated to AI, this is designed to include video generation within the agent’s scope of work.
An example prompt is: “Use /hyperframes to create a 10-second product introduction with a fade-in title, background video, and subtle BGM.” Skills serve to break down such abstract requests into concrete HTML generation and rendering steps.
Design Philosophy Behind the 20 Skills and
the Router
HyperFrames bundles 20 skills and adopts a system where the agent loads only what is needed on demand. At its core is the “/hyperframes” router. This router functions as a capability map, selecting the appropriate workflow for requests such as “I want to make a video,” “I want to make a deck,” or “I want to port a composition,” and guiding the user to the corresponding domain skill.
By default, it is recommended to install only the core set. The router installs required authoring workflows on demand, avoiding bloat at initial installation. Specifically, the core set includes the router, domain skills prefixed with hyperframes-*, and media-use. The Figma integration skill is treated as on-demand and is added only when needed.
This design aims to curb the agent’s context consumption and the loading of unnecessary skills. Rather than loading all 20 skills at all times, it keeps execution lightweight by enabling only the necessary paths on demand. The fact that not only video generation but also surrounding workflows such as deck generation and composition porting are handled under the same router suggests an intent to broaden the range of deliverables.
Optimizing Installation and Updates
Installation behavior differs between interactive and non-interactive modes. In interactive mode, the picker is launched with the following command:
npx skills add heygen-com/hyperframes
The picker opens with nothing pre-selected, and it is recommended to select only the “Core Skills” group. For agents or non-interactive execution, the following is recommended:
npx hyperframes skills update
This command installs only the core set accurately. In contrast, npx skills add --all installs all SKILL.md files in the repository. In addition to the 20 published skills, it includes six internal repository skills under .claude/skills and .agents/skills, which may cause unintended bloat.
Also, npx skills add resolves the registry blob of skills.sh, but reflection to the main branch may be delayed by several hours. If the latest skills are needed, npx hyperframes skills update installs directly from main, making it more suitable when immediacy is required. To intentionally install all published skills, use npx hyperframes skills, and to install only a specific one, use npx skills add heygen-com/hyperframes --skill <name>.
For post-installation maintenance, npx hyperframes init keeps the core set up to date. It updates the router, domain skills, and media-use in addition to what is already installed, but it does not arbitrarily expand a partial installation to the full set. The authoring workflows themselves are installed on demand when the router executes npx hyperframes skills update <workflow>. It is explicitly stated that there is no policy of re-fetching everything in the background.
Integration into Hosted Authoring Workflows
HyperFrames is intended not only for local and agent-linked use but also for embedding as the rendering core of hosted authoring workflows. By functioning as an engine that deterministically converts versatile inputs — HTML and CSS — into MP4, it allows SaaS or internal tools to build their own authoring experiences.
It also supports plugin distribution for Codex. To generate an uploadable archive from the manifests, brand assets, and skills contained in the committed HEAD of the repository, run:
bun run package:codex-plugin
The result is dist/hyperframes-plugin.zip. This archive is in a format ready for upload to Codex. The availability of a means to automate distribution to the agent ecosystem enhances its maturity as a developer-facing framework.
Similarly, as a video generation infrastructure premised on agent integration, there is also the move toward opening agents of large-scale models as reported in Tencent Hunyuan Hy3 Official Release: Free Agent Access. While HyperFrames differs in that it provides a rendering infrastructure rather than a model itself, it can be seen as complementing the flow where AI agents directly generate deliverables.
Editorial Opinion
In the short term, we expect implementations that connect AI coding agents with video generation to accelerate. The ability to repurpose existing HTML and CSS skills lowers the barrier to adoption, and trials for routine tasks such as marketing assets, product introductions, and automated deck generation could spread within 3 to 6 months. We view the design of distributing 20 skills via a router as a pragmatic choice that is mindful of agent context efficiency. In the long term, this could trigger the generalization of version control and CI integration for video production. Deterministic rendering is highly compatible with text-diff reviews, automated testing, and mass personalized generation. Within 1 to 3 years, web front-end production flows and video production flows may converge, and component-driven video operations could become established. On the other hand, the limits of expressing advanced motion graphics and complex effects with HTML/CSS alone will also be called into question. As a question from the editorial team, it remains to be seen to what extent HTML-based video can achieve both expressiveness and performance.
References
-
“heygen-com /
hyperframes", by **heygen-com** — GitHub Trending, 2026-09-08 (ARR) -
Source URL: https://github.com/heygen-com/hyperframes
Frequently Asked Questions
- What kind of framework is HyperFrames?
- It is an open-source framework that generates deterministic MP4 videos from HTML, CSS, media, and seekable animations. It can be used locally via CLI, via skills for AI coding agents, or as the rendering engine behind hosted authoring workflows.
- How does it integrate with AI agents?
- It uses 20 skills and a "/hyperframes" router. The router selects the appropriate workflow according to the request and guides it to the corresponding domain skill. It works with Claude Code, Cursor, Gemini CLI, Codex, and others, automatically executing everything from HTML generation to linting, previewing, and rendering from natural-language instructions.
- What should be noted during installation?
- In interactive mode, it is recommended to select only Core Skills with `npx skills add heygen-com/hyperframes`. In agent or non-interactive environments, `npx hyperframes skills update` accurately installs the core set. Note that `--all` installs everything including internal skills, which may cause unintended bloat.
Comments