Source: Install the Studio app, Make your first video in the Studio app, Connect your agent — HeyGen HyperFrames docs (fetched 2026-11-01; ai-research/hyperframes-studio-app-install.md, ai-research/hyperframes-studio-app-first-video.md, ai-research/hyperframes-studio-app-connect-agent.md); Make videos with a free agent and the Studio-app section of Troubleshooting, added 2026-11-01 (ai-research/hyperframes-free-agents.md, ai-research/hyperframes-troubleshooting-2026-11-01.md)

Companion articles: Editing, Script Panel and Agent Hand-off · Brand Kits, Reference Videos and Video 1 Clips · Export, Cloud Rendering and Review Links

Project: HeyGen HyperFrames · URL: https://hyperframes.heygen.com/studio-app/index · Version: not stated on the pages

The HyperFrames Studio app is a desktop app for Mac, Windows and Linux that HeyGen’s docs call “the easiest way to make a video with HyperFrames.” You describe a video, a coding agent running on your own computer (Claude Code, Codex, Grok, Antigravity, GitHub Copilot or OpenCode) builds it, and you change it by typing, pointing at the picture, drawing, or commenting, with no code. It is a different product from the browser Studio editor that npx hyperframes preview launches (the @hyperframes/studio package in HyperFrames Packages), but projects are interchangeable: each one is a normal HyperFrames project that also opens in the browser editor and the CLI.

Key Takeaways

  • Free app, three separate bills. Sign-in uses a free HeyGen account. HeyGen media (avatars, generated clips, HeyGen voices) spends HeyGen credits only when you ask for it. The agent bills its own provider plan, and OpenCode runs free models at no cost.
  • Bring your own agent, and the app installs it. On the first request without an agent, a Connect an agent sheet installs one with the vendor’s official installer (about a minute) and walks you through sign-in.
  • Brief, then questions, then storyboard, then build. One sentence on Home → the agent asks question cards for anything that matters and you left out → a still-frame Storyboard with timings to approve → the finished video plays in Preview.
  • Plan for real wait times. HeyGen’s own demo, recorded with Claude Code, took 29 minutes for the storyboard and 10 for the build.
  • Guided launch-video builder. Take the step by step assembles a launch video from four parts taken from real launch videos (Hook, Proof, Turn, Call to action). Typing your website gives the agent your fonts, colors and logo.
  • Agent permissions default to Auto. Auto allows project work and internet use and blocks risky steps. ^[ambiguous] The troubleshooting page lists internet use under Full access instead. Full access installs and runs anything with no checks, and GitHub Copilot and OpenCode only run under Full access.
  • Platforms: Mac (Apple Silicon or Intel), Windows 64-bit Intel/AMD, Linux 64-bit Intel/AMD (.deb or AppImage). Windows on Arm is not supported yet; use an agent or the Claude.ai/ChatGPT MCP route there.

Install

All downloads come from hyperframes.studio/studio.

OSDownloadInstall
MacDownload for macOS (Safari/Firefox show Apple Silicon with an Intel link)Open the disk image, double-click Install HyperFrames, wait for Checking it is really from HeyGen (a minute or two), then Open HyperFrames
WindowsDownload for Windows → Install-HyperFrames.exeRun it; the publisher should read HeyGen
Linux (.deb)HyperFrames-amd64.deb for Debian, Ubuntu and derivativessudo apt install ./HyperFrames-amd64*.deb
Linux (AppImage)One portable filechmod +x HyperFrames-x86_64*.AppImage then ./HyperFrames-x86_64*.AppImage
  • Mac fallbacks: if the system Applications folder is locked for your account, the installer uses ~/Applications. The download looks damaged → Download again. If the check took too long, nothing was installed → Try again.
  • First launch: an optional survey asks what you want to make and which agent you use. Skip all counts as an answer. Your answers decide where Build your video opens, and the named agent starts your first chat if it is already set up. A usage-data notice is dismissed with Got it.
  • HeyGen sign-in: triggered on your first click after the survey. Continue with HeyGen opens hyperframes.dev in the browser; finish within 10 minutes and the app shows You’re in! Not now defers until the next click. Sign in or out later at Settings > Account.
  • Updates: automatic. A round button appears bottom-right when an update is ready, and the app restarts once nothing is running, reopening your project. Manual check: Settings > Updates > Check for updates.

Where files live

WhatLocation
ProjectsHidden ~/.hyperframes-studio folder, or the folder a project was imported from
Exported videosDownloads folder
Settings and sign-inMac ~/Library/Application Support/HyperFrames · Windows %APPDATA%\HyperFrames · Linux ~/.config/HyperFrames

Connect an agent

AgentSign-inBilled byInstall commandSign-in command
Claude CodeBrowser: Claude account or Anthropic Console accountAnthropiccurl -fsSL https://claude.ai/install.sh | bashclaude auth login
CodexBrowser: ChatGPT accountOpenAIcurl -fsSL https://chatgpt.com/codex/install.sh | shcodex login
GrokCode confirmed in browserxAIcurl -fsSL https://x.ai/cli/install.sh | bashgrok login
AntigravityTerminal (the sheet gives the command)Googlecurl -fsSL https://antigravity.google/cli/install.sh | bashrun agy once
GitHub CopilotTerminal (the sheet gives the command)GitHubcurl -fsSL https://gh.io/copilot-install | bashcopilot login
OpenCodeNone; runs free modelsFreecurl -fsSL https://opencode.ai/v2/install | bashoptional: opencode providers login
  • Three steps: choose Install (or Use for an agent already on the machine) → sign in → the app sends the request you started with once the agent answers.
  • When a step fails, the sheet shows the command: Copy → Open Terminal → paste. The install and sign-in commands are the ones in the table above.
  • Billing: runs bill to the plan of the account the agent is signed in with. To bill an API key instead, change Bill runs to in Settings > Permissions.
  • Switching: the agent picker in the chat header changes the agent from your next request. Set the default agent, model and effort in Settings > Agent. Settings > Permissions shows each agent’s state (Ready, Not signed in, Not installed, Needs an update) with a button that fixes it.

Make your first video

  1. Say what you want. In Make something, type one sentence (the docs’ example: “A 12-second launch teaser for Lumen, a running shoe that glows at night”) and choose Let’s go. Attach files with +, or start from a video you like in the Reference tab. Home also has a Script tab and a Remix from inspiration feed.
  2. Answer its questions. The agent asks with cards, for example which of three concepts, how the product should look, or whether to use your own image. It marks the option it recommends. Something else… lets you type your own answer, then Send answer.
  3. Approve the storyboard. With Start with a storyboard on (the default), every shot appears as a still with its timing in the Storyboard tab. Ask for changes to specific frames, or choose Build the video.
  4. Watch, then change it. The finished video plays in Preview. Edit it by saying the change, pointing at it, or drawing on it. See Studio App — Editing, Script Panel and Agent Hand-off.

If you are not signed in or have no agent, the app handles both first and then sends the request.

The step-by-step launch-video builder

Take the step by step sits next to Remix from inspiration on Home and also opens automatically the first time the app runs.

PartWhat it does
HookGrab attention in the first seconds
ProofShow the product doing its job
TurnFlip from problem to answer
Call to actionLand the brand and the ask

Shuffle the parts until you like them, enter your website or an idea, and choose Use this cut.

  • Brief-writing practice: HeyGen links a free 20-minute lesson, “The brief”. Its definition: a brief is the goal, who it is for, two to four specifics, and the exact words in quotes.

Running It Free

Source: ai-research/hyperframes-free-agents.md.

  • HyperFrames itself is free, and the agent is the only cost. Rendering, previews, Kokoro voices, background removal, the bundled sound effects, and transcription done by your own agent all run locally at no charge. HeyGen voices, avatars and generated clips use HeyGen credits.
  • OpenCode in the app: free models, no sign-in, needs Full access.
  • Fully local: OpenCode can use an Ollama model (pick one that supports tools), so nothing leaves the machine and nothing is billed. Local models are slower and weaker, so start with short videos.
  • How good are open models? In HeyGen’s Code2Video benchmark (168 briefs, Elo-ranked, published by HeyGen, the tool’s vendor), the open-weight models Qwen 3.8 Max, DeepSeek V4.1 Flash, Kimi K3 and GLM 5.3 all came within 50 Elo points of first place. HeyGen’s own verdict: top models are still better at timing, composition and finish, and an open model is “often enough” for a first draft, a social post or learning the tool. The benchmark is also on Kaggle.

Troubleshooting

Source: ai-research/hyperframes-troubleshooting-2026-11-01.md (Studio-app section). HeyGen’s framing: most problems “come from the agent it works with… not from HyperFrames.”

SymptomFix
Asked to sign in to HyperFramesContinue with HeyGen, finish within 10 minutes. On renewal errors check the internet, and that a VPN or proxy covers all apps
Signed out of Claude CodeSign-in card in chat (your message is kept) → Sign in, or Use Codex instead. For Codex: Copy sign-in command → run it → Try again
”Claude Code hit its usage limit”That’s your agent plan’s limit, not HyperFrames’. Wait for the reset, or Switch to Codex / Switch to Claude Code
A step blocked under AutoIt shows as blocked in the run’s work log. Switch to Full access in Settings > Agent and resend
Agent not installed or won’t startTry again (the app installs it), or Reinstall in Settings > Permissions
”… ran out of room in this chat”Start a fresh session
”… needs an update to use” a modelUse the update button in the chat
Update stallsUpdate button → Try again or Download it instead. Automatic updates (on by default) is in Settings > Updates. On Mac: HyperFrames > Check for Updates…

The rest of that troubleshooting page (preview, browser editor, renders) covers the code-first path and is not compiled here. The June version is in HyperFrames Common Mistakes & Troubleshooting.

Try It

  1. Install from hyperframes.studio/studio, sign in with HeyGen, and connect the agent you already pay for (Claude Code signs in with your existing Claude account, so there is no extra subscription
  2. For a zero-cost trial, connect OpenCode. It runs free models but needs Full access, so try it in a throwaway project first.
  3. Run the step-by-step builder with your own website URL and compare its Hook/Proof/Turn/CTA cut against a hand-authored launch-video playbook build.
  4. Leave Start with a storyboard on. Approving stills is far cheaper than rebuilding a finished video, given the 10-minute build in HeyGen’s demo.
  5. To hand a project to a coding agent or render pipeline, open the project folder under ~/.hyperframes-studio with npx hyperframes preview or render from the CLI.

Implementation

Tool/Service: HyperFrames Studio app (HeyGen), desktop, Mac/Windows/Linux.

Setup: download from hyperframes.studio/studio → install → optional survey → Continue with HeyGen → Connect an agent (app-managed install plus sign-in).

Cost: the app is free with a free HeyGen account. HeyGen credits are spent only on HeyGen media you request (avatars, generated clips, HeyGen voices). Agent runs bill to the agent’s account plan, or to an API key via Bill runs to. OpenCode is free.

Integration notes: projects are standard HyperFrames projects, so they round-trip with the browser Studio editor and the CLI. Windows on Arm users should use an agent with the HyperFrames skills (Skills Catalog) or the Claude.ai/ChatGPT MCP route instead. To move an existing Claude Code or Codex project into the app and back, use npx hyperframes open and npx hyperframes catch-up (hand-off details).

Open Questions

  • The three pages show no version number or release date for the desktop app.
  • The install page says the app records usage data but does not say what. Opting out is not documented on these pages.