Skip to content

Commit 1da8643

Browse files
committed
Merge remote-tracking branch 'origin/main' into dslivers/far-scenes-skip-render
2 parents 94576f0 + 683e9b1 commit 1da8643

34 files changed

Lines changed: 301 additions & 141 deletions

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "hyperframes",
33
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
4-
"version": "0.8.196",
4+
"version": "0.8.197",
55
"author": {
66
"name": "HeyGen",
77
"email": "[email protected]",

‎.codex-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "hyperframes",
33
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
4-
"version": "0.8.196",
4+
"version": "0.8.197",
55
"author": {
66
"name": "HeyGen",
77
"email": "[email protected]",

‎.cursor-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"name": "hyperframes",
44
"displayName": "HyperFrames by HeyGen",
55
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
6-
"version": "0.8.196",
6+
"version": "0.8.197",
77
"author": {
88
"name": "HeyGen",
99
"email": "[email protected]"

‎.github/workflows/ci.yml‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -328,6 +328,16 @@ jobs:
328328
- run: bash scripts/ci/install-workspace-dependencies.sh
329329
- run: bun run build
330330
- run: bun run verify:packed-manifests
331+
env:
332+
PACK_KEEP_DIR: ${{ startsWith(github.head_ref, 'release/v') && format('{0}/release-tarballs', runner.temp) || '' }}
333+
- name: Keep the release tarballs
334+
if: startsWith(github.head_ref, 'release/v')
335+
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
336+
with:
337+
name: release-tarballs
338+
path: ${{ runner.temp }}/release-tarballs/*.tgz
339+
if-no-files-found: error
340+
retention-days: 7
331341
- run: bun run check:cli-lazy-deps
332342
- name: Share the built CLI with the edit accuracy shards
333343
if: needs.changes.outputs.edit_accuracy == 'true'

‎docs/changelog.mdx‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,35 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
88

99
{/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
1010

11+
<Update
12+
label="HyperFrames v0.8.197"
13+
description="Released - 2026-10-25"
14+
tags={["Release", "Engine", "Sdk", "Lint"]}
15+
>
16+
Cloud renders of opaque VP9 video use compressed frames instead of lossless ones, which cuts their cost by about 40 percent. Snapshot reports a clip it cannot read instead of saving a black frame, and Studio frees each closed project's memory.
17+
18+
## Features
19+
20+
- **Lint:** Warn when a round-capped line hidden by its dash settings can still show a dot ([2bff65b0cd13d](https://github.com/heygen-com/hyperframes/commit/2bff65b0cd13da6613e8d64e9202a0569ff6cdfa), [#6291](https://github.com/heygen-com/hyperframes/pull/6291)).
21+
22+
## Fixes
23+
24+
- **Sdk:** Release the parsed film when a session is disposed ([495dc95acdf73](https://github.com/heygen-com/hyperframes/commit/495dc95acdf738f419eb644439ca1e90b94b511e), [#6289](https://github.com/heygen-com/hyperframes/pull/6289)).
25+
- **CLI:** Snapshot fails with the clip and time instead of a silent black frame ([a7273f71478b4](https://github.com/heygen-com/hyperframes/commit/a7273f71478b43147faa6c426188ef2383142547), [#6274](https://github.com/heygen-com/hyperframes/pull/6274)).
26+
- **CLI:** A check that is stopped by a signal prints the report it has so far ([1f740ca21a4ab](https://github.com/heygen-com/hyperframes/commit/1f740ca21a4ab2e90116ecfcc553e87ed7241062), [#6282](https://github.com/heygen-com/hyperframes/pull/6282)).
27+
28+
## Performance
29+
30+
- **Engine:** Vp9 and vp8 sources without an alpha plane extract as jpeg ([382a14d73e7ab](https://github.com/heygen-com/hyperframes/commit/382a14d73e7ab5b77f2c118a012338364c4373b8), [#6284](https://github.com/heygen-com/hyperframes/pull/6284)).
31+
- **Core:** Text edits stop rebuilding the preview's caches every frame ([751ca755f21e1](https://github.com/heygen-com/hyperframes/commit/751ca755f21e14e9094fdc077f681e4914ca6c3d), [#6276](https://github.com/heygen-com/hyperframes/pull/6276)).
32+
33+
## Internal
34+
35+
- Two flaky queue tests no longer race real time or the first copy's start ([4d154c6a237f4](https://github.com/heygen-com/hyperframes/commit/4d154c6a237f47d03ba6bd087afce1042620d706), [#6283](https://github.com/heygen-com/hyperframes/pull/6283)).
36+
37+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.196...v0.8.197).
38+
</Update>
39+
1140
<Update
1241
label="HyperFrames v0.8.196"
1342
description="Released - 2026-10-25"

‎docs/docs.json‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1129,8 +1129,8 @@
11291129
"href": "/product-updates"
11301130
},
11311131
{
1132-
"label": "Playground",
1133-
"href": "https://www.hyperframes.dev/"
1132+
"label": "Download the Studio app",
1133+
"href": "https://hyperframes.dev/studio/download?src=docs-footer"
11341134
},
11351135
{
11361136
"label": "GitHub",
@@ -1149,8 +1149,8 @@
11491149
],
11501150
"primary": {
11511151
"type": "button",
1152-
"label": "Playground",
1153-
"href": "https://www.hyperframes.dev/"
1152+
"label": "Download Studio",
1153+
"href": "https://hyperframes.dev/studio/download?src=docs-navbar"
11541154
}
11551155
},
11561156
"redirects": [

‎docs/go-further.mdx‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Go further with HyperFrames"
33
sidebarTitle: "Go further"
4-
description: "Take more control of an existing project through your agent, Studio, richer composition tools, and a reliable finish."
4+
description: "Take more control of an existing project through your agent, the Studio app or the browser editor, richer composition tools, and a reliable finish."
55
---
66

77
import { AdvancedPathGrid } from "/snippets/advanced-path-grid.jsx";
@@ -15,13 +15,14 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
1515
/>
1616
</div>
1717

18-
The project does not change format as you gain control. Your agent, Studio, the
19-
SDK, the Player, and the renderer all work from the same HTML project.
18+
The project does not change format as you gain control. Your agent, the Studio app, the browser editor, the
19+
SDK, the Player, and the renderer all work from the same HTML project. Made it with your agent on a Mac?
20+
[Open it in the Studio app](/studio-app/existing-project) and keep going there.
2021

2122
## Choose by the size of the change
2223

23-
Use the agent for changes to the story or several scenes. Use Studio for the
24-
specific visual or timing detail you can point at.
24+
Use the agent for changes to the story or several scenes. Use the browser editor, or point at the picture in the
25+
Studio app, for the specific visual or timing detail you can see.
2526

2627
<AdvancedPathGrid />
2728

@@ -30,6 +31,6 @@ For reusable content and nested structure, continue with [Variables](/concepts/v
3031

3132
## Related topics
3233

33-
- [Edit the project visually in Studio](/studio)
34+
- [Edit the project by hand in the browser editor](/studio)
3435
- [Understand how a HyperFrames project works](/concepts)
3536
- [Build on HyperFrames as a developer](/developers)

‎docs/guides/choose-creation-path.mdx‎

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,45 @@
11
---
22
title: "Choose how to create"
33
sidebarTitle: "Choose how to create"
4-
description: "Four places to make a HyperFrames video, and how to tell which one is yours."
4+
description: "Five places to make a HyperFrames video, and how to tell which one is yours."
55
---
66

7-
There are four places to make a HyperFrames video. They all give you a video.
7+
There are five places to make a HyperFrames video. They all give you a video.
88
The difference is what you keep afterwards. Unsure? Take the first one.
99

1010
| Start here | You end up with |
1111
| --- | --- |
12+
| The Studio app (Mac, Linux) | A project you keep editing by chatting, pointing and drawing, your agent beside the preview |
1213
| A coding agent on your computer | A project folder you own and keep editing |
1314
| An AI chat | A video made and kept in your HeyGen account |
1415
| A design tool | A look to finish on your computer |
1516
| HeyGen Video Agent | A finished video, assembled for you |
1617

17-
## Start on your computer if the video will change
18+
## Start in the Studio app if you want to watch it change
19+
20+
The free app for Mac and Linux runs your own agent (Claude Code, Codex, GitHub Copilot, or OpenCode with free
21+
models) beside a live preview and a timeline. You change the video by typing, pointing at the picture or drawing on
22+
it, and each agent run has its own **Undo**. Windows is coming soon.
23+
24+
[Install the Studio app →](/studio-app)
25+
26+
## Start with your coding agent if you work in a terminal
1827

1928
A coding agent — an AI assistant that works in a folder on your machine, like
2029
Claude Code or Cursor — writes a plain HTML project. Revise it with the agent,
21-
open it in Studio, read the source, make the MP4 locally.
30+
open it in the browser editor, read the source, make the MP4 locally. This works on any system, Windows included.
2231

2332
```text
2433
Using /hyperframes, make a 10-second product intro for https://example.com.
2534
```
2635

27-
[Make your first local video →](/quickstart)
36+
[Make your first video with your agent →](/quickstart#with-your-agent)
2837

2938
## Start in an AI chat if you want nothing installed
3039

3140
The hosted HyperFrames connector (an MCP connector — a plug-in an AI chat can
3241
use) builds and renders through your HeyGen account. You give up the project
33-
folder, Studio, and local rendering.
42+
folder, the editors, and local rendering.
3443

3544
[Connect HyperFrames to an AI chat →](/guides/mcp)
3645

‎docs/quickstart.mdx‎

Lines changed: 73 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,57 @@
11
---
22
title: "Make your first video"
3-
description: "Install the HyperFrames skills, make one short request, and continue with your agent, Studio, or the CLI."
3+
description: "Make your first HyperFrames video in the free Studio app for Mac and Linux, with your own AI agent, or in an AI chat with nothing to install."
44
---
55

66
import { QuickstartContinuationGrid } from "/snippets/quickstart-continuation-grid.jsx";
77
import { DocsVideo } from "/snippets/docs-video.jsx";
88

9-
<div className="hf-docs-video-frame">
10-
<DocsVideo
11-
title="A beginner creates a first HyperFrames video from one short request, then continues with an agent, Studio, or the CLI."
12-
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-quickstart-v5-v2.mp4"
13-
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-quickstart-v5.jpg"
14-
/>
15-
</div>
9+
HyperFrames turns one sentence into a video you can keep editing. Start in the Studio app; if you are on Windows or
10+
already work with an AI agent in a terminal, use one of the other two ways. All three make the same kind of project.
11+
12+
<DocsVideo
13+
title="A first video in the Studio app: one request, a few questions, a storyboard, the finished film"
14+
src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/first-video-demo-v2.mp4"
15+
poster="/public/images/studio-app/first-video-demo-v2.jpg"
16+
aspect="16 / 10"
17+
autoPlay
18+
loop
19+
/>
1620

1721
<Note>
18-
HyperFrames is free and open-source, and local rendering does not use HeyGen credits. Your coding
19-
agent and any optional hosted, voice, avatar, or generated-media services may have their own
20-
costs.
22+
HyperFrames is free. Your AI agent bills its own plan, and HeyGen media such as avatars and generated clips uses
23+
HeyGen credits only when you ask for it.
2124
</Note>
2225

23-
## The short way: hand it to your agent
26+
## In the Studio app
27+
28+
The easiest way: the app runs your agent beside a live preview, and you change the video by typing, pointing or
29+
drawing. For Mac (Apple Silicon or Intel) and Linux; Windows is coming soon.
30+
31+
<Steps>
32+
<Step title="Download and install">
33+
<a href="https://hyperframes.dev/studio/download?src=docs-quickstart">Download the Studio app</a>, open it, and
34+
sign in with a free HeyGen account. [Install the Studio app](/studio-app) has the steps for each system.
35+
</Step>
36+
<Step title="Ask for the video">
37+
Type what you want in **Make something** and send it. Framey asks a few questions, shows a storyboard, then
38+
builds the film.
39+
</Step>
40+
<Step title="Change it">
41+
Ask for changes in the chat, or point at the picture. [Make your first video in the app](/studio-app/first-video)
42+
walks through it.
43+
</Step>
44+
</Steps>
45+
46+
## With your agent
2447

25-
If you already have a coding agent open in a folder, paste this and skip the
26-
rest of the page. It installs the skills, makes the video, and opens the
27-
preview — you only change the URL.
48+
For Claude Code, Codex, Cursor, Copilot, Gemini CLI or any agent that works in a folder on your computer, on any
49+
system.
50+
51+
### The short way
52+
53+
If you already have a coding agent open in a folder, paste this. It installs the skills, makes the video, and opens
54+
the preview. You only change the URL.
2855

2956
```text
3057
Set this folder up for HyperFrames and make me a video.
@@ -34,51 +61,49 @@ Set this folder up for HyperFrames and make me a video.
3461
3. Open the local preview when it is done and tell me the project folder.
3562
```
3663

37-
Swap `https://example.com` for the page you want the video to show. Everything
38-
below is the same thing done by hand, if you would rather see each step.
39-
40-
## 1. Install the plugin or skills
64+
### Step by step
4165

42-
For Claude Code, Copilot, VS Code, Cursor, or Gemini CLI, start with the
43-
[plugin installation guide](/guides/plugins). It includes update settings for
44-
each agent. Claude's plugin entry skill is `/hyperframes:hyperframes`.
66+
<Steps>
67+
<Step title="Install the plugin or skills">
68+
For Claude Code, Copilot, VS Code, Cursor, or Gemini CLI, start with the
69+
[plugin installation guide](/guides/plugins). It includes update settings for each agent. Claude's plugin entry
70+
skill is `/hyperframes:hyperframes`.
4571

46-
For standalone skills, run this in your project folder:
72+
For standalone skills, run this in your project folder, choose **Core Skills** in the picker, then open or
73+
restart your agent in that folder:
4774

48-
```bash
49-
npx skills add heygen-com/hyperframes
50-
```
51-
52-
Choose **Core Skills** in the picker. Then open or restart your coding agent in that folder.
53-
54-
## 2. Ask for the video
55-
56-
```text
57-
Using /hyperframes, make a 10-second product intro for https://example.com.
58-
```
75+
```bash
76+
npx skills add heygen-com/hyperframes
77+
```
78+
</Step>
79+
<Step title="Ask for the video">
80+
```text
81+
Using /hyperframes, make a 10-second product intro for https://example.com.
82+
```
5983

60-
Replace `https://example.com` with the real page you want the video to show. The agent will propose
61-
a direction and ask for anything important that is missing. You do not need to write a production
62-
specification.
84+
Replace `https://example.com` with the page you want the video to show. The agent proposes a direction and asks
85+
for anything important that is missing.
86+
</Step>
87+
<Step title="Continue from the first version">
88+
The agent leaves you with a project folder and opens its preview in the browser editor. To reopen it later, run
89+
`npx hyperframes preview` in the project folder. All three paths below work on the same project.
6390

64-
## 3. Continue from the first version
91+
<QuickstartContinuationGrid />
92+
</Step>
93+
</Steps>
6594

66-
The agent leaves you with an editable project folder and opens its local preview.
67-
To reopen that preview later, run `npx hyperframes preview` inside the project
68-
folder. Watch the first version once and check the story, facts, readable text,
69-
and sound; it is not a guaranteed final cut. All three paths below work with
70-
the same project.
95+
## In an AI chat, nothing to install
7196

72-
<QuickstartContinuationGrid />
97+
In Claude.ai or ChatGPT, the HyperFrames connector builds and renders the video in your HeyGen account. You give up
98+
the project folder and local rendering. [Connect HyperFrames to an AI chat](/guides/mcp).
7399

74100
## Related topics
75101

76102
<CardGroup cols={2}>
77103
<Card title="Choose what to make" icon="route" href="/workflows">
78-
Product launch, explainer, captions, recut, pull request, music, motion graphic, or
79-
presentation.
104+
Product launch, explainer, captions, recut, pull request, music, motion graphic, or presentation.
80105
</Card>
81-
<Card title="Go further" icon="arrow-right" href="/go-further">
82-
Direct the agent, edit in Studio, build richer projects, and finish with confidence.
106+
<Card title="Continue from Claude Code in the app" icon="arrow-right" href="/studio-app/existing-project">
107+
Open a project your agent made in the Studio app, and hand it back.
83108
</Card>
84109
</CardGroup>

‎docs/snippets/advanced-path-grid.jsx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ export const AdvancedPathGrid = () => {
1515
poster: "https://static.heygen.ai/hyperframes-oss/docs/images/showcase/go-further-agent-revision-loop-v1.jpg",
1616
},
1717
{
18-
title: "Edit in Studio",
18+
title: "Edit in the browser editor",
1919
detail: "Change visible design, text, media, timing, and animation in the live project.",
20-
action: "Open the Studio guide",
20+
action: "Open the browser editor guide",
2121
href: "/studio",
2222
video: `${CDN}/studio-direct-edit-loop-v2.mp4`,
2323
poster: `${CDN}/studio-direct-edit-loop-v2.jpg`,
@@ -33,7 +33,7 @@ export const AdvancedPathGrid = () => {
3333
{
3434
title: "Check, render, and share",
3535
detail:
36-
"Validate the project, render through Studio, an agent, or the CLI, and review the file.",
36+
"Validate the project, render through the browser editor, an agent, or the CLI, and review the file.",
3737
action: "Finish the project",
3838
href: "/guides/export-and-share",
3939
video: `${CDN}/studio-check-render-loop-v5.mp4`,

0 commit comments

Comments
 (0)