> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Hyperframes

> Hyperframes turns HTML compositions into rendered video — a code-driven, deterministic video framework built for agents and developers. Write HTML, render video.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research-5.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=422da140ece4b799d490f85bb2013ca5)

**Hyperframes is a video framework that turns an HTML composition into a rendered video.** You author a scene as a self-contained HTML/CSS/JS page, and Hyperframes plays its timeline through a headless browser and encodes the result to a video file. The tagline says it best: **write HTML, render video — built for agents.**

<video autoPlay loop muted playsInline poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/code-3d-extrude.png">
  <source src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/code-3d-extrude.mp4" type="video/mp4" />
</video>

Code 3D Extrude — a catalog block built entirely from HTML, CSS, and WebGL, rendered to video by Hyperframes.

If you can build a web page, you can build a video. And because the whole composition is code, it's trivial for an AI agent or a backend pipeline to generate, parameterize, and render thousands of variations without ever opening a video editor.

> [!NOTE]
>
> This page introduces the framework and its concepts. When you're ready to render on HeyGen's infrastructure via the API, go to [Hyperframes Cloud Rendering](https://heygen-1fa696a7.mintlify.site/hyperframes.md).

## Why Hyperframes

* **HTML is the timeline.** Compositions are ordinary web pages — HTML, CSS, JavaScript, [GSAP](https://gsap.com/) animations, WebGL shaders. No proprietary editor format to learn.
* **Deterministic rendering.** Same input, identical output, every time. A composition renders frame-for-frame identically whether it runs on your laptop or HeyGen's cloud — essential for reproducible, automated pipelines.
* **Parameterized by design.** Read runtime values from the document and override them at render time, so one bundle produces many videos (see [Variables](#core-concepts) below).
* **Built for agents and pipelines.** Programmatic authoring and rendering means an LLM or a service can produce finished video end to end.
* **A rich component library.** 150+ prebuilt blocks and components — code animations, data visualizations, social cards, lower thirds, shader transitions, device mockups, and more.

## See what you can build

Every clip below is a catalog block — pure HTML/CSS/JS, rendered to video by Hyperframes. Click any preview to open its source in the [catalog](https://hyperframes.heygen.com/catalog).

{catalog.map((b) => (
    <a key={b.slug} href={`https://hyperframes.heygen.com/catalog/blocks/${b.slug}`} target="_blank" rel="noreferrer" style={{ textDecoration: "none", display: "block" }}>
      <video autoPlay loop muted playsInline poster={`${HF_ASSET}/${b.slug}.png`} style={{ width: "100%", borderRadius: "12px", display: "block", aspectRatio: "16 / 9", objectFit: "cover" }}>
        <source src={`${HF_ASSET}/${b.slug}.mp4`} type="video/mp4" />
      </video>
      <span style={{ display: "block", marginTop: "0.5rem", fontSize: "0.85rem", opacity: 0.7 }}>{b.label}</span>
    </a>
  ))}

## How it works

**1. Author a composition**

Build a scene as a self-contained HTML page — layout in CSS, motion in GSAP or your animation runtime of choice, timing driven by Hyperframes data attributes.

**2. Preview and iterate**

Render and preview locally with the Hyperframes tooling while you design, or explore community compositions to remix.

**3. Render to video**

Render to MP4, MOV, WebM, GIF, or a PNG sequence — locally, or on HeyGen's hosted cloud via the [Cloud Rendering API](https://heygen-1fa696a7.mintlify.site/hyperframes.md).

## Core concepts

| Concept | What it is |
| - | - |
| **Composition** | The fundamental building block — a video scene defined in HTML. |
| **Data attributes** | The `data-*` hooks that control timing and playback behavior for elements in a composition. |
| **Variables** | Values you parameterize a composition with (via `data-composition-variables`), overridden at render time to produce many videos from one bundle. |
| **Frame adapters** | Integration points for custom animation runtimes beyond the defaults. |

## Ways to render

> [card] [Local & self-hosted](https://hyperframes.heygen.com/packages/core)
>
> Render on your own machine or your own cloud (AWS Lambda, Google Cloud Run) with the Hyperframes developer tooling. Best while authoring and iterating.

> [card] [HeyGen Cloud Rendering](https://heygen-1fa696a7.mintlify.site/hyperframes.md)
>
> Upload your project bundle and let HeyGen render it — no infrastructure to run. This is the path documented in these API docs.

## Where to go next

* Combine a HeyGen avatar video with music, sound effects, and Hyperframes graphics into one finished video → [Hyperframes + HeyGen](https://heygen-1fa696a7.mintlify.site/hyperframes-heygen.md)
* Explore and remix community-built compositions → [Community Playground](https://www.hyperframes.dev)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.