Session Report — 21 April 2026
+Fork, install, configure, and verify the HeyGen Hyperframes open-source video rendering framework for local use with API-based rendering and Claude Code agent skills.
+Section 01
+Objective: Analyse, fork, install, and operationally verify the heygen-com/hyperframes open-source video rendering framework — establishing a local authoring environment with HTTP API-based rendering and agent skill integration for Claude Code.
Section 02
+| Action | Outcome |
|---|---|
| Repo analysis | +Full architectural breakdown of heygen-com/hyperframes: 7-package TypeScript monorepo (cli, core, engine, player, producer, shader-transitions, studio). Apache 2.0. 8k+ stars. | +
| Fork to Corhelix | +Created github.com/Corhelix/hyperframes via gh repo fork. Upstream tracking configured. |
+
| Bun installed | +v1.3.13 installed to ~/.bun/bin/bun. Added to $PATH in ~/.zshrc. |
+
| git-lfs installed | +Installed via Homebrew. Hook conflict with graphify post-checkout hook — resolved via GIT_LFS_SKIP_SMUDGE=1 on clone. |
+
| Local clone | +/Users/burns/Documents/hyperframes/ — 1,160 packages installed via bun install. |
+
| Agent skills installed | +5 skills via npx skills add heygen-com/hyperframes --yes: hyperframes, hyperframes-cli, hyperframes-registry, gsap, website-to-hyperframes. Symlinked into Claude Code. |
+
| Producer server built | +bun run build:producer — fonts generated (42 faces, 718KB), runtime compiled, server bundled to dist/public-server.js. |
+
| Producer server verified | +Running at http://localhost:9847. Health check confirmed. Test render: 2s 640×360 composition → 15KB MP4 in 4 seconds. Full pipeline operational. |
+
| Knowledge memory saved | +reference_hyperframes_setup.md created and indexed in MEMORY.md for future session continuity. |
+
Section 03
+| Decision | Rationale | Impact |
|---|---|---|
| Fork to Corhelix user account | +Corhelix is a GitHub user account, not an organisation. gh repo fork --org fails for user accounts. |
+ Fork lives at Corhelix/hyperframes. Can sync upstream via gh repo sync. |
+
| API rendering via producer server, not local CLI | +User preference: avoid persistent RAM drain from Chrome + FFmpeg. Producer server runs only when needed. | +Rendering via POST /render to localhost:9847. Future: Docker/Azure for fully decoupled rendering. |
+
| LFS skip smudge on clone | +graphify post-checkout hook conflicts with git-lfs hooks. git lfs update --force would overwrite graphify hook. |
+ LFS-tracked files (large assets) not downloaded. Pull selectively with git lfs pull if needed. No impact on authoring or rendering. |
+
| Local producer for now, Docker/Azure deferred | +User wants to explore the tool before investing in infrastructure. Azure account available for future deployment. | +Rendering currently uses local Chrome + FFmpeg when producer is running. RAM impact is temporary (only while server is active). | +
Section 04
+| File | Action | Purpose |
|---|---|---|
/Users/burns/Documents/hyperframes/ |
+ Created (clone) | +Local Hyperframes repo — full monorepo with all 7 packages | +
~/Documents/hyperframes/.agents/skills/ |
+ Created (skills install) | +5 agent skills symlinked into Claude Code | +
~/.bun/bin/bun |
+ Created (install) | +Bun v1.3.13 package manager — required for Hyperframes dev tooling | +
~/.claude/.../memory/reference_hyperframes_setup.md |
+ Created | +Knowledge memory: full setup reference for future sessions | +
~/.claude/.../memory/MEMORY.md |
+ Modified | +Added Hyperframes entry to Tools & Integrations index | +
Section 05
+POST /render, POST /render/stream with SSE, POST /lint, GET /health). Rendering is deterministic — same HTML composition always produces the same video output. No external API dependencies; entirely self-contained.
+ GIT_LFS_SKIP_SMUDGE=1) is functional but means LFS-tracked assets are not automatically fetched. If large video assets are needed for compositions, run git lfs pull explicitly.
+ bun is added to ~/.zshrc but not available in non-login subshells. Commands must use PATH="$HOME/.bun/bin:$PATH" bun ... or ~/.bun/bin/bun directly until a new terminal session is opened.
+ Prerequisites
+Node.js v22.19.0
+FFmpeg v8.0.1
+Bun v1.3.13
+Chromium v146 (Puppeteer cache)
+Producer API Endpoints
+POST /render — blocking
POST /render/stream — SSE
GET /render/queue — status
POST /lint — validate
GET /health — check
GET /outputs/:token — download
Agent Skills
+hyperframes — authoring
+hyperframes-cli — CLI
+hyperframes-registry — components
+gsap — animations
+website-to-hyperframes — conversion
+Section 06
+bun run dev)# Start the producer server
+cd /Users/burns/Documents/hyperframes
+node packages/producer/dist/public-server.js
+# Server at http://localhost:9847
+
+# Render a composition
+curl -X POST http://localhost:9847/render \
+ -H "Content-Type: application/json" \
+ -d '{"html": "<div id=\"stage\" ...>...</div>"}'
+
+# Open the studio editor
+PATH="$HOME/.bun/bin:$PATH" bun run dev
+
+# Rebuild producer (after upstream sync)
+PATH="$HOME/.bun/bin:$PATH" bun run build:producer