HyperFrames
Write HTML, render deterministic MP4; a video framework whose primary interface is agent skills and a CLI.
HeyGen's open-source framework turns HTML, CSS, media, and seekable animations into video. Twenty skills teach a coding agent to plan, write, lint, preview, and render compositions; the CLI does the same by hand. Local rendering is free; HeyGen-hosted cloud rendering and AWS Lambda are the scale-out paths.
- I want my agent to make product promos and explainers as HTML I can read and diff, not a proprietary project file
- I need deterministic batch renders from templates and want to run them on Lambda or HeyGen's cloud
- A non-interactive `skills add` without --skill installs all 20 skills; agents should use `npx hyperframes skills update` for the core set
- The skills.sh registry can lag main by hours
- Renders need Chromium through Puppeteer; check `hyperframes doctor` first
Last activity Sep 3, 2026. Fit: adaptable 3, operable 3.
Editions
Free · Free open source
- Clone
git clone https://github.com/heygen-com/hyperframes - Install
npx skills add heygen-com/hyperframes
Cloud render · Free closed source
- HostedOpen the hosted app
Adaptable: what is yours to change
Make it yours
Light edit8 things to edit
A project is a folder with hyperframes.json and an index.html composition; adapting a template means editing the HTML, the data-* timing attributes, and hyperframes.json (schema in docs/schema/hyperframes.json). No env var is required for local use; GEMINI_API_KEY is optional. The skills themselves are Markdown you can edit or extend.
- Env vars
GEMINI_API_KEY- Config files
hyperframes.jsonindex.html.env- Prompt files
skills/hyperframes/SKILL.mdskills/hyperframes-core/SKILL.mdskills/media-use/SKILL.mdAGENTS.md- Accounts you need
- HeyGen account (cloud render only)AWS (Lambda render only)
Source
- github.com/heygen-com/hyperframes
- Apache-2.0 license
- Last commit Sep 3, 2026
- 43,734 stars
Operable: what an agent can drive
Interface
NativeCLIpublished by the builderremote or local
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
- Docs
- github.com/heygen-com/hyperframes#skills
- Tools
hyperframes initlintchecksnapshotpreviewrenderpublishdoctorcloud renderlambda deploy/render/progresshyperframes add
Reach
Complete coverage. 10 of 10 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Plan and write a composition from a brief | Reachable | README: /hyperframes router plus creation workflows (/product-launch-video, /faceless-explainer, /general-video) |
| Lint and check a composition | Reachable | README /hyperframes-cli: lint, check |
| Preview in the browser | Reachable | README: npx hyperframes preview |
| Render MP4 locally | Reachable | README: npx hyperframes render |
| Render in HeyGen cloud or AWS Lambda | Reachable | README /hyperframes-cli: cloud render, lambda deploy / render / progress |
| Add captions to talking-head footage | Reachable | README: /embedded-captions workflow |
| Source or generate music, SFX, images, voice | Reachable | README: /media-use resolves or generates media, TTS, transcription |
| Mix audio already in the composition | Reachable | README: /hyperframes-audio effect chain and automation |
| Install registry blocks and components | Reachable | README: hyperframes add, /hyperframes-registry |
| Port a Remotion composition | Reachable | README: /remotion-to-hyperframes one-way migration |
Code stack
- Languages
- TypeScriptHTMLCSS
- Frameworks
- GSAPPuppeteerffmpeg
- Package manager
- bun
- Database
- none
- Hosting target
- localHeyGen cloud renderAWS Lambda
- Built
- Unknown (recorded, never ranked)
Model stack
- Providers
- optional Gemini for integrationsany coding agent with skills support
- Models
- none
- Keys you need
GEMINI_API_KEY (optional)- Prompts live in
skills/*/SKILL.mdAGENTS.mdCLAUDE.md
Skills
Ships about twenty video-production skills that are the intended way to drive the CLI; a router skill installs the rest on demand.
- Kind
- bundled
- Paths
.agents/skills/*/SKILL.md- Install
npx skills add heygen-com/hyperframes
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | README: npx hyperframes CLI plus agent skills; Studio is secondary | 90% |
| executionModel | README: deterministic MP4 from HTML; models only in optional media generation | 75% |
| operability | README tagline 'Built for agents'; skills and CLI shipped by heygen-com | 95% |
| effort | .env.example says no env vars required; hyperframes.json schema in docs/schema; compositions are HTML | 85% |
| editions | Apache-2.0 LICENSE; README lists HeyGen-hosted cloud rendering; price not in README | 70% |
| active | GitHub pushedAt 2026-09-03 | – |
| reach | 90% |
Open questions
- Cloud render pricing and the auth flow (packages/cli/src/commands/auth.ts, docs/guides/authentication.mdx) were not fetched; record price and env var names
- Provenance: HeyGen has not stated how the framework was written
Sources
- github.com/heygen-com/hyperframes sourcing:video-streaming:github