HyperFrames
HTML-native video rendering framework built for AI agents
๐ Overview
HyperFrames is an open-source framework that turns HTML, CSS, media, and seekable animations into deterministic MP4 videos. Instead of React components or proprietary timelines, you write plain HTML files with data attributes for timing and tracks, then use GSAP, Three.js, Lottie, Anime.js, WAAPI, or CSS for animation. The renderer uses headless Chrome (Puppeteer) to seek each frame and FFmpeg to encode โ producing pixel-identical output from the same input every time. It ships with 19 agent skills that teach coding agents (Claude Code, Cursor, Gemini CLI, Codex) the full video production loop: plan, write HTML, wire animations, lint, preview, render. HeyGen uses it in production, and adopters include tldraw and TanStack.
โจ Key Features
- โขHTML-native compositions โ no build step, no React requirement; an index.html plays and renders as-is
- โข19 production-tested agent skills turn coding agents into video production studios
- โขDeterministic rendering via Puppeteer + FFmpeg โ same input, same frames, same output, CI-safe
- โขMulti-runtime animation adapters: GSAP, Three.js, Lottie, Anime.js, WAAPI, CSS, custom frame adapters
- โขAWS Lambda rendering for distributed encode pipelines driven from a laptop or CI
- โขframe.md design system converts existing DESIGN.md tokens into a video-ready superset an agent can compose from
- โขCatalog of reusable blocks: shader transitions, social overlays, animated charts, maps, kinetic captions
๐ฏ The Problem It Solves
Video production is still stuck in manual editing suites while every other content pipeline has been automated. Existing code-based tools (Remotion) require React expertise and a bundler โ too heavy for AI agents that already think in HTML. HyperFrames meets agents where they live: plain HTML files anyone can write, with deterministic rendering that makes video CI-safe for the first time.
๐ง How It Works
You write an HTML file with data-* attributes for timing (data-start, data-duration, data-track-index) and attach seekable animations via GSAP, CSS keyframes, WAAPI, or any custom adapter registered through window.__timelines. The CLI (hyperframes preview) launches Puppeteer for live preview with hot reload; hyperframes render seeks each frame deterministically and encodes to MP4 via FFmpeg with audio mixing. The same composition can deploy to AWS Lambda for distributed rendering.
๐ Installation & Quick Start
Installation
npx hyperframes init my-videoQuick Start
- Run npx hyperframes init my-video && cd my-video
- Edit index.html with data-start/data-duration/data-track-index attributes
- Add GSAP or CSS animations via class="clip" and window.__timelines
- npx hyperframes preview to iterate in browser with live reload
- npx hyperframes render to encode deterministic MP4
โ Pros
- โขHTML-native authoring โ agents already write HTML, no React/JSX learning curve
- โข19 agent skills work with Claude Code, Cursor, Gemini CLI, Codex out of the box
- โขDeterministic rendering makes video CI-safe โ same composition, same output every time
- โขMulti-runtime animation: GSAP, Three.js, Lottie, Anime.js, WAAPI, CSS, custom adapters
- โขNo build step โ compositions play directly in browser via file://
- โขAWS Lambda rendering for distributed encode without managed infrastructure
- โขframe.md converts existing design systems into video-ready specs automatically
- โขApache 2.0 license with no per-render fees or enterprise upgrade pressure
โ Cons
- โข197 open issues โ active development means some workflows can break between releases
- โขAWS Lambda rendering lacks multi-region support outside the US
- โขNo native editorial round-trip โ MP4-only output, no DaVinci/Final Cut export
- โขYounger ecosystem than Remotion โ fewer templates, case studies, and community tutorials
๐ฌ Practitioner Verdict
โHyperFrames is the first video framework designed ground-up for the agent era, and it shows. The HTML-native approach is obviously correct for AI pipelines โ you describe what you want in plain language, the agent writes valid HTML, Puppeteer renders deterministic MP4s. The 19-skill pipeline is not a gimmick; it is a genuinely new interaction model for video creation. The trade-off is ecosystem maturity โ Remotion has more production case studies and a bigger community, but HyperFrames is growing fast and already has production use at HeyGen, tldraw, and TanStack. If you are building agent-driven video content, this is the default choice.โ
Self-Hosted (Free)
Open source, MIT/Apache licensed. Run it yourself.
โญ Star & Clone on GitHubFree forever. Your infrastructure, your data.
hyperframes.dev Playground
Hosted community playground for previewing, iterating, sharing, and rendering
- Browser-based preview
- Composition sharing
- Design template gallery
Deployment Options
Ways to run HyperFrames in production
๐ Specifications
- Language
- TypeScript
- License
- Apache 2.0
- Platform
- Linux, macOS, Windows
- Supported Models
- REST API, CLI
๐ฐ Pricing Reality
Completely free and open source under Apache 2.0. No per-render fees, no commercial-use thresholds, no paid tier. hyperframes.dev offers a hosted playground; AWS Lambda rendering pays standard AWS rates.