HyperFrames

npm version npm downloads License Node.js

Write HTML. Render video. Built for agents.

HyperFrames demo — HTML code on the left transforms into a rendered video on the right

Hyperframes is an open-source video rendering framework that lets you create, preview, and render HTML-based video compositions — with first-class support for AI agents. ## Quick Start ### Option 1: With an AI coding agent (recommended) Install the HyperFrames skills, then describe the video you want: ```bash npx skills add heygen-com/hyperframes ``` This teaches your agent (Claude Code, Cursor, Gemini CLI, Codex) how to write correct compositions and GSAP animations. Then just prompt it: > "Create a 10-second product intro video with a fade-in title, a background video, and background music" The agent handles scaffolding, animation, and rendering. ### Option 2: Start a project manually ```bash npx hyperframes init my-video cd my-video npx hyperframes preview # preview in browser (live reload) npx hyperframes render # render to MP4 ``` `hyperframes init` installs skills automatically, so you can hand off to your AI agent at any point. **Requirements:** Node.js >= 22, FFmpeg ## Why Hyperframes? - **HTML-native** — compositions are HTML files with data attributes. No React, no proprietary DSL. - **AI-first** — agents already speak HTML. The CLI is non-interactive by default, designed for agent-driven workflows. - **Deterministic rendering** — same input = identical output. Built for automated pipelines. - **Frame Adapter pattern** — bring your own animation runtime (GSAP, Lottie, CSS, Three.js). ## How It Works Define your video as HTML with data attributes: ```html
``` Preview instantly in the browser. Render to MP4 locally or in Docker. ## Catalog 50+ ready-to-use blocks and components — social overlays, shader transitions, data visualizations, and cinematic effects: ```bash npx hyperframes add flash-through-white # shader transition npx hyperframes add instagram-follow # social overlay npx hyperframes add data-chart # animated chart ``` Browse the full catalog at **[hyperframes.heygen.com/catalog](https://hyperframes.heygen.com/catalog/blocks/data-chart)**. ## Documentation Full documentation at **[hyperframes.heygen.com/introduction](https://hyperframes.heygen.com/introduction)** — [Quickstart](https://hyperframes.heygen.com/quickstart) | [Guides](https://hyperframes.heygen.com/guides/gsap-animation) | [API Reference](https://hyperframes.heygen.com/packages/core) | [Catalog](https://hyperframes.heygen.com/catalog/blocks/data-chart) ## Packages | Package | Description | | ---------------------------------------------------------------- | ----------------------------------------------------------- | | [`hyperframes`](packages/cli) | CLI — create, preview, lint, and render compositions | | [`@hyperframes/core`](packages/core) | Types, parsers, generators, linter, runtime, frame adapters | | [`@hyperframes/engine`](packages/engine) | Seekable page-to-video capture engine (Puppeteer + FFmpeg) | | [`@hyperframes/producer`](packages/producer) | Full rendering pipeline (capture + encode + audio mix) | | [`@hyperframes/studio`](packages/studio) | Browser-based composition editor UI | | [`@hyperframes/player`](packages/player) | Embeddable `` web component | | [`@hyperframes/shader-transitions`](packages/shader-transitions) | WebGL shader transitions for compositions | ## Skills HyperFrames ships [skills](https://github.com/vercel-labs/skills) that teach AI agents framework-specific patterns that generic docs don't cover. ```bash npx skills add heygen-com/hyperframes # HyperFrames skills npx skills add greensock/gsap-skills # GSAP animation skills ``` | Skill | What it teaches | | ------------------------------------------------- | ---------------------------------------------------------------------- | | `hyperframes-compose` | HTML composition structure, `data-*` attributes, timeline registration | | `hyperframes-captions` | Caption/subtitle authoring and transcript integration | | `hyperframes-registry` | Block and component installation via `hyperframes add` | | `gsap-core`, `gsap-timeline`, `gsap-plugins`, ... | GSAP animation API, sequencing, ScrollTrigger, performance | ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. ## License [Apache 2.0](LICENSE)