HyperFrames V2: The HTML-to-MP4 Framework Built for AI Agents

HyperFrames V2 cover
IX
IX Interaction Lab
Prototyping team focused on AI agent tooling and creative automation. ix-works.xyz
2026-05-11
~ 9 min read

HyperFrames V2: The HTML-to-MP4 Framework Built for AI Agents

A small architectural shift — letting LLMs author video as plain HTML — is collapsing the cost of producing 100 polished video variants down to the cost of producing one.

What HyperFrames Actually Does

HyperFrames takes HTML, CSS, and JavaScript as input and produces an MP4 file. Under the hood it's surprisingly direct — headless Puppeteer captures every frame, then FFmpeg stitches them into a video. No proprietary timeline format, no special editor, no cloud.

The crucial detail is deterministic rendering. Same HTML in, same MP4 out, every single time. That property is what unlocks the real use case: an AI agent can write a video composition the way it writes a function. Tell Claude "build a 30-second intro about a product launch," and it produces HTML plus a GSAP timeline. Render that file and you have a finished video. No human in the loop.

The Core Specs at a Glance

Before getting into V2's changes, the project baseline as of May 2026 — straight from the public repository[1].

FIG.01 — PROJECT BASELINE v0.5.7
LICENSE
Apache-2.0
Commercial use, no fees, no seat caps
GITHUB
17,000 ★
As of May 2026
OUTPUT
1920×1080
30fps default · 4K/60 via flags
FORMATS
MP4 · MOV · WebM
FFmpeg-backed encoding
RUNTIME
Fully Local
No API keys, no cloud
RELEASE
v0.5.7
2026-05-10
Six baseline metrics that frame V2's scope

What's Actually New in V2

V2 is less about adding capabilities and more about making the tool usable for actual content creators. Three changes carry the weight.

FIG.02 — V2 SHIPPING NOTES 3 changes
01
Subtitle Pipeline
The hyperframes-media skill handles TTS and transcription end-to-end. Drop in audio, get timed subtitles. HTML/CSS styling stays in your control.
02
Catalog of 50+ Blocks
Floating cards, quote callouts, stat tickers, comparison slides — all synced against a shared GSAP timeline. One command: npx hyperframes add quote-card.
03
Frame Adapter Pattern
HyperFrames no longer assumes GSAP. anime.js, CSS animations, Lottie, three.js, and WAAPI all run side-by-side in the same composition. The runtime mediates them.
Each lifts a different friction the v1 community kept hitting

The Frame Adapter is the architectural shift worth dwelling on. Want a Lottie icon, a GSAP-driven title, and a three.js background scene in one frame? V1 would have asked you to pick a side. V2 just runs them.

Claude Code Integration: The Skills System

This is the part that matters most for developers in the Anthropic ecosystem. As Skills matured, HyperFrames split itself into modular pieces that plug directly into Claude Code.

Installation is a single line:

npx skills add heygen-com/hyperframes

After that, the following slash commands become available inside Claude Code:

FIG.03 — SKILL SURFACE /slash commands
/hyperframes Author the composition (HTML body)
/hyperframes-cli init / lint / preview / render
/hyperframes-media TTS, transcription, BG removal, asset prep
/gsap GSAP timeline guidance
/tailwind Tailwind v4 browser-runtime styles
/animejs · /lottie · /three
/css-animations · /waapi
Adapter-specific helpers for each runtime
Top three are the workflow spine — the rest are adapters

The end-to-end loop: developer prompts Claude with "make a 60-second minimalist product intro," Claude invokes /hyperframes to write the composition, then runs /hyperframes-cli render to produce the MP4. The user inspects the result. That's it.

How HyperFrames Differs From Remotion

Programmatic video isn't new. Remotion[2] has been doing roughly the same thing in the React world for years. HyperFrames diverges on two deliberate axes.

FIG.04 — DESIGN AXIS COMPARISON two frameworks
Remotion
React-first
▸ JSX component tree as composition unit
▸ Built for programmers who make videos
▸ Strong typing, IDE tooling, React ecosystem
HyperFrames
Agent-first
▸ Plain HTML — LLM-native generation surface
▸ Built for AI agents that make videos
▸ --non-interactive flag baked in
Same problem space — different user assumed in the first commit

Put differently: LLMs generate HTML naturally. They don't need to hold a JSX component tree in working memory. The barrier between "describe a video" and "produce code that becomes a video" drops dramatically.

Getting Started: Your First Render

Prerequisite: Node.js 18 or higher. The fastest way to feel the difference is to render something.

FIG.05 — FIRST-RUN PATH ~ 4 steps
01
Scaffold
npx hyperframes init
→
02
Preview
npx hyperframes preview
→
03
Hot-reload
Edit index.html
→
04
Render MP4
--output out.mp4
From empty directory to finished MP4 in four commands
# 1. Scaffold a project
npx hyperframes init my-first-video

# 2. Move in and preview
cd my-first-video
npx hyperframes preview

# 3. Browser opens — edits hot-reload automatically

# 4. Render to MP4
npx hyperframes render index.html --output out.mp4

For a 30-second 1080p / 30 fps composition, expect roughly 1–2 minutes on a modern laptop. Because the rendering is deterministic, CI environments reproduce it byte-for-byte[3].

Where This Changes Production Workflows

HyperFrames isn't a single-creator tool. It's pipeline plumbing. Five scenarios where it earns its keep.

FIG.06 — DEPLOYMENT SCENARIOS 5 workflows
Daily Pipeline
RSS → LLM → MP4 → YouTube
Daily news summaries, fully unattended
Variants
100 product spots in one job
Vary tone, length, language across versions
Data Viz
D3 / Chart.js recap videos
Monthly revenue recaps without editing
Education
Code snippets as HTML scenes
Animation + captions + output, all in markup
Short-form social
1080×1920 vertical at scale
Reels and TikTok output without per-asset hand-editing
Each scenario shares one trait — volume that breaks a human editor's day

The HeyGen team also released website-to-hyperframes, a skill that converts a marketing page URL into a video composition automatically. Run it on your landing page and you get a 1–2 minute promo without writing a script[4].

Honest Limitations

Worth being clear about what HyperFrames is not.

FIG.07 — WHAT IT IS / ISN'T honest read
✓ Strong For
Information-delivery video
Programmatic / templated output
CI-reproducible rendering
Hundreds of variant jobs
✗ Not the Right Tool
4K/60 long-form (slow capture)
Realtime-editor responsiveness
Particle systems, shaders, grading
DaVinci / After Effects territory
The Claude Code skills cushion the GSAP learning curve significantly, but the first hour still feels foreign

If you don't already know GSAP timelines or CSS animation conventions, the first hour is awkward. Heavy compositing work still belongs in DaVinci or After Effects. HyperFrames is sharpest when the job is deliver information at volume, not craft a single hero film.

The Real Shift: Code and Video Stop Being Separate Disciplines

HyperFrames V2 is not really about "another video tool." The deeper signal is that video, as a medium, has become expressible in code — and the code can be written by language models. When those two conditions hold simultaneously, the unit economics of content production change category.

FIG.08 — THESIS
"

Producing one polished video used to be the bottleneck. Producing a hundred variants automatically becomes the new baseline.

The HyperFrames V2 thesis
The same shift that programmatic ad creative gave to performance marketing a decade ago

For Claude Code users specifically, the path to getting started is one line of installation and one slash command. The cost of trying it is effectively zero. The upside is structural — the same kind of leverage that programmatic ad creative gave to performance marketing teams a decade ago, now coming for video content.

댓글