mirror of https://github.com/hanzoai/frames.git synced 2026-09-24 00:08:03 +00:00

T

JamesandClaude Opus 4.6 1eb19a802d fix(cli): remove empty src attrs from swiss-grid audio elements

Empty src="" on <audio> elements causes the browser to fetch the
current page URL as the audio source, producing 404 errors in the
console during rendering. These are placeholder sound effect slots
whose src should be set dynamically when audio is configured.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

2026-03-26 21:06:00 +00:00

.github

fix: rewrite workspace deps before npm publish (#67 )

2026-03-26 21:14:39 +01:00

docs

docs: audit and fix all documentation against actual codebase

2026-03-26 18:23:32 +00:00

packages

fix(cli): remove empty src attrs from swiss-grid audio elements

2026-03-26 21:06:00 +00:00

scripts

fix: rewrite workspace deps before npm publish (#67 )

2026-03-26 21:14:39 +01:00

skills

feat(skill): house style guide for compose-video (#59 )

2026-03-26 11:15:16 -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

fix(producer): embed font data at build time instead of runtime require.resolve

2026-03-26 20:59:11 +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

fix(cli): resolve npx hyperframes from inside monorepo (#47 )

2026-03-26 10:25:19 -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

fix: rewrite workspace deps before npm publish (#67 )

2026-03-26 21:14:39 +01: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.