mirror of https://github.com/heygen-com/hyperframes.git synced 2026-08-31 02:41:44 +00:00

T

Miguel Ángel bca76ce82e fix(ci): make publish steps idempotent with continue-on-error (#51 )

Already-published versions cause npm to return E403. With
continue-on-error, the workflow skips published packages and
continues to publish the remaining ones. Safe to re-run.

2026-03-25 19:15:06 +01:00

.github

fix(ci): make publish steps idempotent with continue-on-error (#51 )

2026-03-25 19:15:06 +01:00

docs

fix(ci): update publish workflow to use bun install (#36 )

2026-03-24 08:46:58 -07:00

packages

fix(ci): remove prepublishOnly build scripts (#50 )

2026-03-25 19:11:37 +01:00

scripts

fix(ci): update publish workflow to use bun install (#36 )

2026-03-24 08:46:58 -07:00

.editorconfig

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

.env.example

initial code (#2 )

2026-03-21 22:43:56 -07:00

.gitattributes

initial code (#2 )

2026-03-21 22:43:56 -07:00

.gitignore

ci(regression): add Docker-based regression test pipeline

2026-03-23 19:08:25 +00:00

.oxfmtrc.json

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

.oxlintrc.json

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

.prettierignore

test(regression): add editor-agent-prod regression fixture

2026-03-24 15:33:13 -04:00

bun.lock

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

CODE_OF_CONDUCT.md

initial code (#2 )

2026-03-21 22:43:56 -07:00

commitlint.config.js

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

CONTRIBUTING.md

docs: add per-package READMEs and polish root docs for OSS launch

2026-03-24 04:53:00 +00:00

Dockerfile.test

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

DOCS_GUIDELINES.md

docs: improve quality based on Remotion/Stripe/Tailwind patterns

2026-03-23 23:57:01 +00:00

knip.config.ts

build: add oxlint, oxfmt, commitlint, lefthook, knip, and editorconfig configs (#23 )

2026-03-23 16:05:47 -07:00

lefthook.yml

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

LICENSE

chore: initial repo setup with README, LICENSE, and contributor docs

2026-03-10 01:57:55 +00:00

package.json

build: migrate from pnpm to bun as package manager (#28 )

2026-03-23 19:50:57 -07:00

pnpm-workspace.yaml

chore: add community docs, workspace config, and gitignore gaps

2026-03-10 04:23:12 +00:00

README.md

style: apply oxfmt formatting to markdown files

2026-03-24 04:54:24 +00:00

SECURITY.md

style: apply oxfmt baseline formatting across all source files (#25 )

2026-03-23 17:15:14 -07:00

README.md

Hyperframes

Write HTML. Render video. Built for agents.

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 via MCP.

Why Hyperframes?

HTML-native — AI agents already speak HTML. No React required.
Frame Adapter pattern — bring your own animation runtime (GSAP, Lottie, CSS, Three.js).
Deterministic rendering — same input = identical output. Built for automated pipelines.
AI-first design — not a bolted-on afterthought.

Quick Start

npx hyperframes init my-video
cd my-video
npx hyperframes dev      # preview in browser
npx hyperframes render   # render to MP4

Requirements: Node.js >= 22, FFmpeg

How It Works

Define your video as HTML with data attributes:

<div id="stage" data-composition-id="my-video" data-start="0" data-width="1920" data-height="1080">
  <video
    id="clip-1"
    data-start="0"
    data-duration="5"
    data-track="0"
    src="intro.mp4"
    muted
    playsinline
  ></video>
  <img id="overlay" data-start="2" data-duration="3" data-track="1" src="logo.png" />
  <audio
    id="bg-music"
    data-start="0"
    data-duration="9"
    data-track="2"
    data-volume="0.5"
    src="music.wav"
  ></audio>
</div>

Preview instantly in the browser. Render to MP4 locally. Let AI agents compose videos using tools they already understand.

Packages

Package	Description
`hyperframes`	CLI — create, preview, lint, and render compositions
`@hyperframes/core`	Types, parsers, generators, linter, runtime, frame adapters
`@hyperframes/engine`	Seekable page-to-video capture engine (Puppeteer + FFmpeg)
`@hyperframes/producer`	Full rendering pipeline (capture + encode + audio mix)
`@hyperframes/studio`	Browser-based composition editor UI

Documentation

Full docs at hyperframes.heygen.com — includes guides, concepts, API reference, and package documentation.

Contributing

See CONTRIBUTING.md for guidelines on how to contribute.

License

See LICENSE for details.