Skip to content
Back to search

iv-studio

Free, open-source AI film studio on your own PC. Recurring characters, MiniMax H3 and Seedance shots, voices, music, a short-film wizard and a real editor, on your ComfyUI or your own cloud GPU. Windows, Mac and Linux, with 217 MCP tools so Claude Code, Codex or Hermes can run it.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hollisorg/iv-studio with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hollisorg/iv-studio'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hollisorg--iv-studio/badge.svg)](/listings/hollisorg--iv-studio)

HTML

<a href="/listings/hollisorg--iv-studio"><img src="/api/listings/hollisorg--iv-studio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. [Download `IV-Studio-Setup.exe`](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-Setup.exe) (about 180 MB). 2. Run it. The installer isn't code-signed yet, so Windows may show **"Windows protected your PC"**. Click **More info → Run anyway**. It installs for your user only; no admin rights needed. 3. Open IV Studio. On first launch **Check my PC** reads your graphics card, memory and drives (nothing leaves your PC), says what it can do, and sets previews, finals, the prompt writer and the downloads to suit; it ends by offering a two-minute tour of the app. IV Studio starts ComfyUI for you when it can. Before your first MiniMax H3 render it asks you to read and agree to the [terms of use](TERMS.md) once. 4. **Settings → Setup** checks ComfyUI, your GPU, the node packs and every model, installs missing node packs into ComfyUI with one click (restart ComfyUI afterwards), and downloads missing models straight into ComfyUI's models folder (each checked against the SHA-256 its host publishes). Its **Updates** row keeps ComfyUI, its node packs and ComfyUI-Manager up to date. 5. For voices, open **Audio → Voices** and press **Set up voices** once. For music, open **Audio → Music** and download the engine you want.

Your projects, voices and songs are kept in `%APPDATA%\IV Studio`; renders are saved in ComfyUI's output folder under `H3\`.

Linux

1. [Download `IV-Studio.AppImage`](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio.AppImage) (about 240 MB), make it executable (`chmod +x IV-Studio.AppImage`) and run it. AppImages need FUSE (`libfuse2`, called `libfuse2t64` on Ubuntu 24.04). 2. IV Studio finds a ComfyUI folder in your home folder (or pick it in Settings → ComfyUI) and starts it with a `.sh` script beside it, or with its `main.py` and the folder's own `venv` Python. ComfyUI's output goes to `comfyui.log` in IV Studio's data folder, `~/.config/IV Studio`. 3. Saving API keys (Civitai, RunPod, Comfy.org) needs a keyring (GNOME Keyring or KWallet). 4. Shinobi, previs and website capture use Google Chrome, Chromium or Microsoft Edge.

What's different: DLSS 5 is Windows-only, so finals use a 2× AI upscale (Real-ESRGAN) and RIFE frame interpolation when those are installed in your ComfyUI, as in the cloud. The Linux build is built and checked on GitHub's Ubuntu machines (every page, the agent server, Shinobi and website capture); renders on a Linux GPU haven't been tried yet. In Settings → Agents, the command for Claude Code or Codex runs a small script that opens the AppImage, so it keeps working after updates.

Mac

A Mac has no NVIDIA graphics card, and MiniMax H3 needs one, so on a Mac IV Studio is the studio and the cloud is the GPU: shots, hunts, finishes and sequences render on your own [RunPod](#on-runpod) or [Modal](#on-modal) account, or on [Comfy Cloud](#on-comfy-cloud).

1. Download the `.dmg` for your Mac: [Apple Silicon (M1 and newer)](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-mac-arm64.dmg) or [Intel](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-mac-x64.dmg). Open it and drag IV Studio into Applications. 2. The app isn't signed with an Apple Developer ID yet, so the first time macOS says it can't check it. Open **System Settings → Privacy & Security**, scroll down and click **Open Anyway** next to IV Studio (once). 3. Open the **Cloud** page (the Dashboard and the title bar point there) and set up RunPod, Modal or Comfy Cloud.

What's different on a Mac:

- **Renders:** in the cloud. Finals there use a 2× AI upscale (Real-ESRGAN) and RIFE frame interpolation in place of DLSS 5, which is Windows-only. - **Pictures and music** need a ComfyUI with their models: Comfy Cloud, or a ComfyUI on your Mac (IV Studio finds and starts the ComfyUI Desktop app, `ComfyUI.app`, or a ComfyUI folder in your home folder). Note that

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 1,401 lines
  1. <p align="center">
  2. <img src="docs/images/banner.png" alt="IV Studio: AI films with recurring actors, on your own PC" width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-Setup.exe"><b>Download for Windows</b></a>
  6. &nbsp;·&nbsp;
  7. <a href="https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-mac-arm64.dmg"><b>Mac (Apple Silicon)</b></a>
  8. &nbsp;·&nbsp;
  9. <a href="https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-mac-x64.dmg"><b>Mac (Intel)</b></a>
  10. &nbsp;·&nbsp;
  11. <a href="https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio.AppImage"><b>Linux (AppImage)</b></a>
  12. &nbsp;·&nbsp;
  13. <a href="#what-you-need">What you need</a>
  14. &nbsp;·&nbsp;
  15. <a href="https://github.com/hollisorg/iv-studio/releases/latest">Release notes</a>
  16. &nbsp;·&nbsp;
  17. <a href="https://infinitevariance.ai">Infinite Variance</a>
  18. </p>
  19. # IV Studio
  20. A free Infinite Variance desktop app for making short films with
  21. [MiniMax H3](https://huggingface.co/MiniMaxAI/MiniMax-H3) on your own PC. Give a recurring actor a face
  22. and a voice, write a shot, hunt a few quick previews and finish the best one at full size. Make
  23. pictures, songs and spoken lines, cut it all together and export. IV Studio drives your own
  24. [ComfyUI](https://github.com/comfyanonymous/ComfyUI); nothing leaves your machine unless you choose the
  25. cloud. No strong graphics card? Shots can also render on a GPU in your own [RunPod](https://www.runpod.io) or
  26. [Modal](https://modal.com) account, billed by the second, or on Comfy Cloud (see [Cloud](#cloud)).
  27. **IV Studio 1.1.7** opens on a simpler welcome that asks how much you already know and keeps things short if
  28. you're new, shows a picture for every one of the 165 **Cinematography** setups, lets **Hermes** write your prompts,
  29. and opens Create's examples and staging board as pop-ups. **1.1.6** lets you name your agent (and tell it your
  30. name), pick a **colour** for the whole app (red, blue, purple, orange or a dark grey), and gives the editor's cut
  31. tool a red katana.
  32. **IV Studio 1.1.4** adds **Hermes** to the chat beside Claude Code and Codex, and a **History** tab for earlier
  33. conversations. The [IV Studio plugin for Hermes](https://github.com/hollisorg/hermes-iv-studio) works the other way
  34. round: Hermes's own `video_generate` and `image_generate` render in IV Studio, on your GPU, for free.
  35. **IV Studio 1.1.3** lets you talk to the chat (it hears you with IV Studio's own speech recognition, on your PC) and
  36. read its replies aloud, shows every agent's work in an **Activity** log with Undo, gives the chat a cleaner look and
  37. its own window, and tells it more about what you're looking at.
  38. **IV Studio 1.1** brings your own Claude Code or Codex into the app as a chat that can make, edit and fix things
  39. for you, MiniMax H3 Image and Seedance 2.5 beside MiniMax H3, effects for any clip, nearly every feature on your
  40. own RunPod or Modal, speed presets for smaller graphics cards, and a new look that fits any window. See
  41. [what's new in 1.1](#whats-new-in-11).
  42. IV Studio is **Powered by MiniMax H3**. Using H3 through it means agreeing to the
  43. [IV Studio terms of use](TERMS.md), which carry MiniMax's use restrictions: IV Studio asks once, before your first
  44. H3 render. To report misuse, email [abuse@infinitevariance.ai](mailto:abuse@infinitevariance.ai).
  45. <p align="center">
  46. <img src="docs/images/create.png" alt="Create: Tess's rainy bus-stop shot with its H3 prompt, the checker's note, the prompt tools and the pinned Your shot card" width="100%">
  47. </p>
  48. ## What's new in 1.1
  49. ### Your own Claude Code, Codex or Hermes, inside IV Studio
  50. - **Chat.** The **Chat** button in the title bar opens a conversation with your own Claude Code, Codex or Hermes, on
  51. your own plan, with every IV Studio tool: it can look things up, write and render shots, sequence, edit, make
  52. music and voices, and answer questions about your projects. It knows which page you're on and which shot,
  53. film or edit is open. Anything that deletes, costs money, installs or changes a setting shows an **Allow /
  54. Don't allow** card first. Conversations are kept: the **History** tab (1.1.4) lists them, newest first, with which
  55. agent and when, and opening one carries on where you left off. On a wide window the
  56. chat sits beside the page; on a smaller one it slides over it. Works on Windows, Mac and Linux.
  57. - **Hermes (1.1.4).** Pick Hermes beside Claude Code and Codex and your own
  58. [Hermes Agent](https://hermes-agent.nousresearch.com) works in the chat, on the model you chose in Hermes. IV Studio
  59. talks to it through Hermes's Agent Client Protocol server (`hermes-acp`, found where Hermes's installer puts it),
  60. gives the session IV Studio's tools, and resumes the same Hermes session for each message. Anything Hermes asks
  61. approval to run outside IV Studio (a shell command, a file edit) is declined and shown as a declined step.
  62. - **Local AI.** Pick Local AI and the chat runs on a model in your own [Ollama](https://ollama.com), free and on your
  63. PC, with nothing sent anywhere. It gets IV Studio's everyday tools (look things up, make shots, pictures, songs and
  64. lines, change an edit, show you around the app) and the same Allow cards; Claude Code, Codex or Hermes can do more.
  65. The model is the prompt writer's unless you pick another in Settings → You and your agent; it has to be able to use
  66. tools (Qwen3, Llama 3.1 and newer). It steps off the graphics card before a render starts. A new `make_shot` tool
  67. goes from a plain-words idea to previews in one step, for any agent.
  68. - **Talk to it (1.1.3).** Press the mic in the chat, say what you want and press send. IV Studio's own Whisper writes
  69. it down on your PC (Audio → Voices → Set up voices once). Talking while the agent works stops its answer and
  70. sends your new words; renders it already started keep going. The speaker button reads each reply aloud in one of
  71. your voices (the first one takes a while as the voice loads; after that a few seconds).
  72. - **Its own window (1.1.3).** The arrow in the chat's header opens it in a window of its own: keep it on top while you
  73. work, and put it back in the app when you're done. It still knows what's open in the main window, and its links
  74. open things there.
  75. - **What it can see (1.1.3).** Besides the page, each message tells the agent what you picked on it (a shot's version,
  76. the clip and playhead in the editor, the item open in the Library, how Create is set up), what's rendering or
  77. waiting, and the last render that failed in the past half hour.
  78. - **Activity (1.1.3).** The chat's Activity tab lists everything agents did in IV Studio: the chat, Dashboard ideas,
  79. and Claude Desktop, Codex, Claude Code or Hermes using IV Studio's MCP server from outside, each by name. Steps that
  80. change something, spend or fail are kept for 30 days (looking things up isn't), with a link to what they made and
  81. **Undo this change** for any agent's change to an edit. Agents can read it too (`list_activity`).
  82. - **Working memory (1.1.3).** The chat's header shows how full the agent's context window is (exact for Claude Code;
  83. estimated for Codex from its usage) and, when clicked, the chat's tokens. A note shows when the agent summarizes
  84. earlier messages to make room. Your plan's 5-hour and weekly limits aren't shared with apps, so they aren't shown.
  85. - **Ask about this.** Buttons around the app hand the chat a question: **Ask … to fix it** on a failed render
  86. (with IV Studio's own explanation), **Ask …** on any run and **Ask … to pick the best take** on the Shot page,
  87. and **Ask … about this** in the Library viewer.
  88. - **Drop files in.** Drop pictures, videos, sound or a script onto the chat, or use its paperclip. The agent can
  89. look at a picture or a moment of a video, and use the files as a first frame, a reference, a song or a script.
  90. - **Show me where.** Ask "where do I train a character?" and IV Studio goes to the right page and lights up the
  91. right button, with the agent's words beside it.
  92. - **Edit by talking.** On an open edit, press **Ask …** and say "tighten the middle", "add a song under it" or
  93. "put captions on". Captions are new: Whisper hears each spoken clip and the words go on as short lines at the
  94. bottom, timed across the clip (silent clips are left alone). Every change the agent makes gets an **Undo
  95. this change** in the chat, even when the edit isn't open, and an open edit shows the change at once.
  96. - **Recipes.** When something works, say "save this as a recipe". It becomes a button on the Dashboard that asks
  97. the chat for the same thing again, written so it works another day.
  98. - **Overnight batches.** "Make 10 variations of this idea overnight, three takes each": the agent writes each
  99. variation and queues them on your PC (free, up to 12). IV Studio keeps the PC from sleeping, ranks the takes
  100. as they finish, and leaves a report in the chat with the best ones to open.
  101. - **A short film in one conversation.** **Make one with …** on Projects: the agent takes an idea through script,
  102. cast, storyboard, shots and rough cut, and stops for your OK at each step. It only starts filming after you
  103. approve the storyboard.
  104. - **A spending limit.** Settings → Agents: let the chat spend Comfy.org credits without asking, up to a daily
  105. amount and an amount per step (off unless you turn it on). Each paid step shows what it spent and how much of
  106. today's limit is used. Renders on your cloud GPU, training and anything without a known price always ask.
  107. Seedance now works from the chat too.
  108. - **Let Claude Code make it.** On the Dashboard, a button beside **Make it** hands your idea to your own agent:
  109. it writes the prompt and renders the previews on this PC, with its steps in a panel and a Stop button. It
  110. never deletes, installs or spends.
  111. - **Install them from IV Studio.** The welcome asks which agent you use (Claude Code, Codex or Hermes) and what to
  112. call it, and Settings → Agents can install Claude Code or Codex with its maker's own installer and open its sign-in.
  113. - **Your agent's name (1.1.6).** Name your agent and tell it yours, in the welcome or Settings → You and your agent.
  114. It answers to that name in the chat, on the Dashboard ("Let Nova make it") and in the activity log.
  115. <p align="center">
  116. <img src="docs/images/chat.png" alt="The chat beside the Dashboard: Claude Code answering which shots aren't finished yet, film by film, after looking them up with IV Studio's tools" width="100%">
  117. </p>
  118. ### Make more
  119. - **MiniMax H3 Image.** A new picture model in Create → Image: big, detailed pictures at 4, 8 or 16 MP that
  120. follow long descriptions closely, with MiniMax's own prompt tips beside the box. It needs ComfyUI 0.45 or
  121. newer and a 22 GB download (Settings → Setup). New pictures are clean; edits with the int8
  122. download come out over-sharpened for now.
  123. - **Seedance 2.5 in Create.** A model switch beside MiniMax H3: the same shots on ByteDance's Seedance 2.5,
  124. through ComfyUI's partner nodes, on your Comfy.org credits. Cheap 480p drafts to try ideas, or 720p and
  125. 1080p takes, 4 to 30 seconds. The price shows on the button and you confirm before anything is charged.
  126. **Write it for me** writes for Seedance from a Seedance 2.5 prompt guide.
  127. - **Your Comfy account.** Settings → Comfy account holds your Comfy.org key and shows your credits, also in
  128. the title bar. Anything paid is priced first, from ComfyUI's own prices, and needs your OK.
  129. - **Free finishes for Seedance takes.** Finish a draft on your own graphics card: SeedVR2 (cleanest), DLSS 5
  130. (quickest), or H3 redrawing it at full size followed by DLSS 5 or SeedVR2.
  131. - **Upscaler strength.** DLSS 5 has a strength and a look (Default, Natural, Cinematic), SeedVR2 an extra-detail
  132. slider and H3's redraw a strength, in the Finish dialog and in Enhance.
  133. - **Effects on any clip.** Right-click a clip in the editor → Effects…: Dub (new words in any language, with new
  134. lip movement), Clean plate, Day to night, Add water, SDR to HDR, Remove background and Smooth or slow motion.
  135. The result takes the clip's place, and Undo brings it back. Built on
  136. [Freefield](https://github.com/neuregex/freefield)'s apps (MIT).
  137. - **Effects, Sounds and picture tools.** Workflows → Effects turns a photo into an effect clip, a transformation
  138. or a transition. Audio → Sounds makes sound effects, ambiences, one-shots and loops with Stable Audio 3.
  139. Create → Image → Tools inpaints (paint over a part and describe it), relights, removes backgrounds, upscales
  140. and makes depth or normal maps.
  141. - **LoRAs for every model.** The LoRAs page and every LoRA picker cover MiniMax H3, LTX-2.5, Wan 2.1, Flux 3
  142. Klein, Flux.2 Klein, Krea 2, Qwen Image 2.1, Z-Image Turbo, SDXL (with Pony and Illustrious) and Moss: find a
  143. model's LoRAs on Civitai, see yours sorted by model, and send one to that model's tray. A LoRA IV Studio
  144. can't place can be assigned by hand.
  145. - **Start from an example.** Create's **Start from an example** button opens six ready-made shots in a pop-up;
  146. each fills in a working prompt. The welcome wizard's **Make your first shot** opens the first one ready to hunt.
  147. - **Speed presets.** Quality, Balanced, Fast and Low memory trade picture size and steps for time and memory.
  148. Check my PC picks the one that suits your card; every preset fits a 12 GB card, the 2 MP finish too.
  149. - **How long, and what it costs.** Hunt and Finish say how long they'll take on your machine, worked out from
  150. your own earlier renders, and what a cloud render will cost.
  151. - **Failed renders in plain words.** Out of memory, a missing model or node pack, a full drive, credits and more
  152. are explained with a button for the fix. ComfyUI's own message is still under Details.
  153. - **Compare and finish.** Mark up to four takes, finals or enhanced copies and play them in sync, side by
  154. side, as a wipe or in a grid, zoomed in on the same spot. Picking a take opens the Finish settings over the
  155. page, and every finished version sits in one card.
  156. - **Library details.** Open any render to see how it was made: model, size, length, seed, character, LoRAs,
  157. how it was finished and enhanced, render time, cost and the prompt (with Copy). Tiles show size, length and
  158. model; search finds words in prompts.
  159. - **An end card, if you want one.** The editor can add a "Made with IV Studio" end card to an export (Edit
  160. settings → End card), off unless you turn it on, and each export shape says where it fits.
  161. <table>
  162. <tr>
  163. <td width="50%"><img src="docs/images/seedance.png" alt="Create with Seedance 2.5 picked: the four kinds of shot, Tess as a face picture, and Hunt 2 takes priced at about $1.48"></td>
  164. <td width="50%"><img src="docs/images/effects.png" alt="Effects on a clip in the editor: Dub, Clean plate, Day to night, Add water, SDR to HDR, Remove background and Smooth or slow motion"></td>
  165. </tr>
  166. <tr>
  167. <td align="center"><sub>Seedance 2.5 beside MiniMax H3, priced before you hunt</sub></td>
  168. <td align="center"><sub>Right-click a clip for Effects</sub></td>
  169. </tr>
  170. <tr>
  171. <td width="50%"><img src="docs/images/compare.png" alt="Compare in Grid: three takes and the finished version of The apple, paused on the same frame"></td>
  172. <td width="50%"><img src="docs/images/library-details.png" alt="The Library viewer: a take of Tess at the bus stop, with what's in it, model, size, length, character, seed, steps, render time, cost and the prompt"></td>
  173. </tr>
  174. <tr>
  175. <td align="center"><sub>Compare up to four versions in sync</sub></td>
  176. <td align="center"><sub>Every render says how it was made</sub></td>
  177. </tr>
  178. </table>
  179. ### Catch problems sooner, finish anywhere
  180. - **Takes that cut away.** H3 sometimes cuts to a close-up nobody asked for in the middle of a one-shot take. The
  181. take card now says "cuts away at 2.4 s", the take scores lower, and **Use 0.0 to 2.4 s** keeps the part
  182. before (or after) the cut in an edit; **Carry on from it** starts a Continue shot from that part, cut to H3's
  183. frame grid. Only hard cuts are caught, not slow dissolves.
  184. - **First and last frames held.** In First / last frame mode each take says whether it really opens on your
  185. first picture and ends on your last.
  186. - **"No …" wording.** H3 has no negative prompt, so "No photographs appear anywhere" can hang photographs on the
  187. wall. The checker lists every "no / without / never / not …" phrase with what to write instead. IV Studio's own
  188. tested lines ("No one speaks.", "There is no writing anywhere in the picture.") stay.
  189. - **Premiere / Resolve.** The editor's **Premiere / Resolve** button: the timeline goes out as FCP 7 XML (Premiere Pro and DaVinci
  190. Resolve), FCPXML 1.10 (Resolve, Final Cut Pro) and a CMX3600 EDL of V1, with every clip copied into a Media
  191. folder beside them and the folder zipped to send. Tracks, trims, pictures, volume, hidden, muted and locked
  192. tracks and markers come over; titles come over as markers (and as text in the FCPXML). Fades and title
  193. styling don't.
  194. - **Recommended LoRAs.** LoRAs → Recommended (MiniMax H3): Camera Motion, Natural Face Speech, Motion
  195. Continuity Repair, Spatial Physics, Head-mounted FPV, 360° Orbit and Transformation, each fixed to one tested
  196. file and checked when it downloads, with what it does, the modes it works in, how to prompt it and its
  197. licence. **Use in a shot** puts it in Create's tray with its trigger and strength.
  198. - **Turnaround sheets.** A character's settings make five views of them turning around from their face
  199. picture, with matlod's Turnaround LoRA and the H3 Contact Sheet nodes (both downloads you choose).
  200. - **Search by what's in a file.** While nothing renders, your local prompt writer (Ollama, or your
  201. OpenAI-compatible server when it sees pictures) looks at each new video and picture in the Library and writes
  202. a sentence and a few tags, so search finds "red car" or "beach at night". It stops as soon as a render starts;
  203. Settings → Prompt writer turns it off.
  204. - **Soft mouth.** A reference video in References mode (and Replace's Swap people) can have its mouths blurred
  205. first, so the new face doesn't mouth the words spoken in it. Off while the shot has a spoken line. It uses the
  206. face models from Characters. H3 can copy the blur into a take's first second; trim it in Edit.
  207. - **Dailies.** When an overnight batch finishes, Videos\IV Studio\Dailies gets a reel of every take, the best
  208. of each shot first, each after a card with its seed and checks, and notes.md on what to look at first. The
  209. chat's report has **Watch the dailies** and **Read the notes**.
  210. These ideas come from keys and Sam Wasserman's Imagination Studio (Apache-2.0); the code is IV Studio's own.
  211. ### Your own cloud does nearly everything
  212. - **Almost every feature on your RunPod or Modal.** Pictures and picture tools, storyboard sketches, character
  213. design, Music, Sounds, Cut out, Reframe, Replace (with Remake), Effects, Retake in the editor, the SeedVR2
  214. finish and Enhance now run on your own cloud GPU, not just shots. The models a render needs download into
  215. your cloud storage the first time, after you agree to the size; your LoRAs and RefMods go up once.
  216. - **Voices in your cloud.** Voices, Lines, Speak it and Whisper's read-backs run on your RunPod or Modal too.
  217. - **Hugging Face models.** A Hugging Face token on the Cloud page (kept sealed) lets the cloud fetch gated models
  218. like LTX-2.5 and Flux.2 Klein.
  219. - **Cloud setup you can follow.** Setting up RunPod or Modal shows each step with a timer and the time left,
  220. and tells you when it's ready (1.0.6). Modal's sign-in, sign-out and new accounts work (1.0.3 to 1.0.5).
  221. - **The IV Studio cloud beta.** Want IV Studio to run the cloud for you? Join the waitlist on the Cloud page or
  222. in Settings → Privacy. Only the email you type is sent, and only when you press Join.
  223. ### Easier to use
  224. - **A simpler welcome (1.1.7).** The first thing IV Studio asks is how much you know about making AI video and
  225. pictures. Then **Make it yours** (your name, your agent, a colour, easier-to-read options), a look at your PC,
  226. where things render, what to download and you're ready: six steps on one row. If you're new to it, IV Studio
  227. keeps each step to a couple of plain sentences and folds the details away with its suggestions already set.
  228. - **Your colour (1.1.6).** Red is IV Studio's own; blue, purple, orange or Dark (greys and white) recolour every
  229. button, highlight and the artwork, in the welcome or Settings → Accessibility.
  230. - **Cinematography you can see (1.1.7).** The **Cinematography** button (with its little cinema camera) opens all
  231. 165 setups as pictures of one scene, a woman in a red coat at a rainy café window, shot each way: film stocks,
  232. lenses, lighting, camera moves, moods. Hover one to read the phrase it adds; camera moves are marked.
  233. - **The staging board in a pop-up (1.1.7).** **Stage it on a board** on Create opens the board large; **Use this
  234. staging** puts a one-line summary under the prompt, with Edit to open it again.
  235. - **Editor tools you can see (1.1.6).** The Razor (C) turns the cursor into a red katana with a guide line, and
  236. each cut flashes a slash (not with Reduce motion). Select, Ripple and Roll have their own cursors and icons.
  237. - **A new look.** Tall animated banners with a quick-start bar on every main page, and an Audio front page.
  238. Nothing flashes (every banner is checked against the WCAG flash limit), animations pause when they're off
  239. screen, and Reduce motion holds them still.
  240. - **Fits any window.** Pages, banners and the title bar adapt to smaller windows, and choice cards wrap
  241. instead of being cut off.
  242. - **Searches that say so.** The search bars in the banners have a **Search** button that takes you to the
  243. results and a count of what matches; **+ New shot**, **+ New film** and **+ New edit** are their own buttons.
  244. - **What's new as a pop-up.** After an update, a small **See what's new in this update** button opens this list.
  245. - **Simple words.** Check my PC asks how much you know about AI video. New to it? IV Studio says
  246. "trained look" for LoRA, "variation number" for seed, "quick sharpen" for DLSS and so on. Only the words
  247. change; switch it in Settings → Words.
  248. - **Get ComfyUI for me.** No ComfyUI yet? Setup downloads ComfyUI's official portable build for your graphics
  249. card into a folder you choose, checks it, unpacks it and starts it. Already have one? IV Studio keeps using it.
  250. - **A tidier Setup.** A status card first, then folding sections that open by themselves when something needs
  251. you. **Restart ComfyUI** is one click (it asks first while renders run), and node packs that are installed
  252. but not loaded yet say so.
  253. - **Less waiting on memory.** Effects free the GPU before their video model loads, and reopening IV Studio while
  254. ComfyUI starts no longer starts a second one.
  255. - **An installer in IV Studio's colours,** with the eye down the side.
  256. - **Scroll bars in the theme, and no clipped corners (1.1.6).** Every page was checked from 1100 × 720 to
  257. 2560 × 1440 with the chat open and closed.
  258. <table>
  259. <tr>
  260. <td width="50%"><img src="docs/images/make-it-yours.png" alt="The welcome's Make it yours step: your name Alex, your agent Nova running on Claude Code, and the five colours with Red the default"></td>
  261. <td width="50%"><img src="docs/images/cinematography.png" alt="The Cinematography menu: the same café scene shot as Editorial, Documentary, Fashion, Street and more, with Fashion and Kodak Portra 400 chosen"></td>
  262. </tr>
  263. <tr>
  264. <td align="center"><sub>Name your agent, tell it yours and pick a colour</sub></td>
  265. <td align="center"><sub>Every cinematography setup as a picture</sub></td>
  266. </tr>
  267. </table>
  268. ### Updates, privacy and credits
  269. - **Updates on a Mac.** Mac copies now download and install new versions themselves, like Windows and Linux:
  270. **Restart to update**, or it installs when you quit. (IV Studio needs to be in your Applications folder.)
  271. - **Privacy.** Settings → Privacy: IV Studio sends nothing about how you use it unless you turn on **Help improve
  272. IV Studio**, which counts only opens and renders, never prompts, pictures or files. Incognito never counts.
  273. - **Training on Fizgig 9.** Character training uses Fizgig 9.3.2, on this PC, Modal and RunPod. RunPod training
  274. pods start from Fizgig's own RunPod template, so your training time supports Fizgig too.
  275. - **Credits.** Settings → About → Credits lists every model, tool, node pack and library IV Studio is built on:
  276. who made it, what it does here and its licence.
  277. - **Terms for MiniMax H3.** Before your first H3 render or training, IV Studio shows the rules for H3 in plain words
  278. and asks you to agree to its [terms of use](TERMS.md) once (they carry MiniMax's licence restrictions and Acceptable
  279. Use Policy). Read them again, or report misuse, in **Settings → About**. If you're updating from 1.0, you'll be asked
  280. at your next H3 render.
  281. ## What's new in 1.0
  282. - **Help on every page.** A **How it works** button on every page lights up its real controls one at a time
  283. with a line on each. The welcome wizard offers a full tour of the app, and Settings → About takes it again.
  284. - **Check my PC.** On first launch IV Studio reads your graphics card, memory, processor and drives (nothing
  285. leaves your PC), says plainly what it can do, and sets previews, finals, the prompt writer and downloads to
  286. suit. A guided cloud setup connects RunPod, Modal or Comfy Cloud in a few steps.
  287. - **Redesigned.** Create (video and image), Settings, Characters, Voices, Lines and Music are numbered step
  288. cards. The Workflows tools (Sizzle, Reel, Sequences, Shinobi and Replace) open on animated stages with their
  289. main bar centered.
  290. - **Find anything.** Shots, Projects and the Library group your work by day and filter it by when, kind of
  291. shot, who's in it and shape, in a panel that folds away. Long histories open at once: tiles load as you
  292. scroll.
  293. - **Train characters anywhere.** Free on your own graphics card (Fizgig), or on your RunPod or Modal account,
  294. with presets, a spending cap, **Train more** and likeness scoring. Or make a **RefMod** character from a few
  295. pictures in seconds.
  296. - **More control.** Pick a shot's sampler and scheduler, and keep a resizable live preview of any render
  297. floating over every page.
  298. ## What it does
  299. - **Dashboard.** IV Studio opens on one-click starts for everything it makes, your latest renders and
  300. your cast. Every page has its own banner art and its own **How it works** tour.
  301. - **Projects.** A short film as a six-step wizard for anyone: an idea, a script (written for you or your
  302. own), the cast and places, a storyboard of drawn sketches you can play as an animatic, filming every
  303. panel, and the finished film. Faces and rooms stay the same from shot to shot.
  304. - **Shots.** Write a shot (or type the idea in plain words and let **Write it for me** write the H3
  305. prompt; it looks at your reference pictures and videos first), hunt one to three quick previews, pick
  306. one and finish it at 1 to 2 MP with DLSS, an RTX 2× upscale and frame generation, or with SeedVR2. Four
  307. modes: text, reference pictures, video and audio, first and last frame, and continuing a video. Create
  308. lays it out as numbered steps beside a pinned **Your shot** card.
  309. - **Directing.** A prompt checker that catches H3 mistakes before you spend a render, @ mentions for your
  310. cast and places, live step pictures while takes render (also in a floating preview over every page),
  311. takes ranked by words heard, likeness and sharpness, side-by-side Compare, a **Review** that names each
  312. problem with its seconds and one fix, and a top-down staging board that becomes exact screen directions
  313. or a moving grey previs.
  314. - **Images.** Create switches between **Video** and **Image**: make or edit pictures with eight image
  315. model families (Flux.2 Klein, Flux 3 Klein, Krea 2, Moss, Qwen Image 2.1, Z-Image Turbo, SDXL and H3
  316. stills with your H3 characters), then use one as a shot's first frame.
  317. - **LoRAs.** Browse Civitai's MiniMax H3 LoRAs as tall picture cards whose clips play on hover, open one
  318. for a full-size gallery of its examples, and download it straight into ComfyUI. Your own LoRAs show as
  319. pictures too, and Create's LoRA tray adds them to a shot with a strength slider.
  320. - **Characters.** Recurring actors as trained H3 LoRAs with a trigger word, or as RefMods made from a few
  321. pictures in seconds. Use the ready-made Tess and Theo, add a LoRA or RefMod you have, or design, clip and
  322. train your own: free on your graphics card, or on your RunPod or Modal account.
  323. - **Voices.** Give each character a voice: design one from a description, or save one from a recording.
  324. Type a line and **Speak it**: the character says it on screen, lip-synced. Runs on your PC with
  325. VoxCPM2 and Whisper.
  326. - **Music.** Songs with sung lyrics, or instrumentals, from a style and lyrics: MiniMax Music 3 for full
  327. songs up to five minutes, ACE-Step 1.5 for a draft in seconds. Put a song under an edit, or have a
  328. character sing it.
  329. - **Edit.** A Premiere-style editor with a full-screen workspace: project bin, source and program
  330. monitors, as many video and audio tracks as you need, filmstrips and waveforms, markers, J/K/L,
  331. insert and overwrite, razor, ripple and rolling trims, and MP4 export at 1080p, 4K, vertical or square
  332. at a set loudness. Right-click to make new footage on the timeline (extend, bridge, fill a gap, retake a
  333. stretch), cut out a person or thing with see-through edges, or reframe a shot to a new shape with H3
  334. drawing what lies beyond its edges.
  335. - **Workflows.** Five tools, each opening on its own animated stage. **Sequences:** several shots as one
  336. continuous video. **Sizzle** turns a website into a promo film: your agent storyboards it from the real
  337. site, then H3 shots, pictures, music and the site's own screens are cut together on the beat. **Reel**
  338. cuts pictures or clips to a song's beat. **Replace** swaps a person or changes the scene in a video while
  339. the camera, motion and sound stay. **Shinobi** lets an agent cut a whole edit in code.
  340. - **Library and Queue.** Every shot, sequence, picture, export, song and spoken line in one place, a day at a
  341. time, filtered by when, where it came from, kind, who and shape. Above it, the render queue shows what's
  342. rendering and what waits.
  343. - **Help.** **How it works** on every page, a full tour from the welcome wizard, What's new after every
  344. update, and the PDF guide.
  345. - **Check my PC.** Reads your hardware on first launch and sets IV Studio up to suit it.
  346. - **Cloud.** Render shots and sequences on your own RunPod or Modal account, or on Comfy Cloud, set up with a
  347. guided wizard, with a running time and cost meter in the title bar and a **Shut down GPU** button.
  348. - **Incognito.** A private space whose work never shows in the normal app.
  349. - **Agents.** A local MCP server with 214 tools and a start menu gives Claude Code or any MCP client nearly
  350. everything a person can do in the window.
  351. - **Updates.** IV Studio updates itself: one click installs a new version and reopens.
  352. <table>
  353. <tr>
  354. <td width="50%"><img src="docs/images/dashboard.png" alt="Dashboard: the What if? banner with Make it and Let Claude Code make it, quick-start cards and recent renders"></td>
  355. <td width="50%"><img src="docs/images/tour.png" alt="How it works: the Create tour lighting up What happens, with its card and Next"></td>
  356. </tr>
  357. <tr>
  358. <td align="center"><sub>Start anything from the Dashboard</sub></td>
  359. <td align="center"><sub>How it works: every page walks you through itself</sub></td>
  360. </tr>
  361. <tr>
  362. <td width="50%"><img src="docs/images/welcome.png" alt="Check my PC: this PC can do everything, with the graphics card, memory, processor, free space and prompt writer rated"></td>
  363. <td width="50%"><img src="docs/images/hunt.png" alt="The apple: three preview takes of the farmer and his dog, each scored, with Review, Mark and Pick, and a review of take 1 below"></td>
  364. </tr>
  365. <tr>
  366. <td align="center"><sub>Check my PC sets IV Studio up for your computer</sub></td>
  367. <td align="center"><sub>Hunt a few takes, review them, pick one and finish it</sub></td>
  368. </tr>
  369. <tr>
  370. <td width="50%"><img src="docs/images/shots.png" alt="Shots: finished References shots under their day, with filters for status, when, kind, who and shape"></td>
  371. <td width="50%"><img src="docs/images/projects.png" alt="Projects: short films under their day, filtered by where each one is"></td>
  372. </tr>
  373. <tr>
  374. <td align="center"><sub>Every shot, a day at a time, with filters</sub></td>
  375. <td align="center"><sub>A short film, step by step</sub></td>
  376. </tr>
  377. <tr>
  378. <td width="50%"><img src="docs/images/image.png" alt="Create in Image mode: Generate, Edit or Tools, and nine image model families"></td>
  379. <td width="50%"><img src="docs/images/staging-board.png" alt="The staging board on Create: two people on a top-down floor, a wide lens and an arc left, and the staging words it writes"></td>
  380. </tr>
  381. <tr>
  382. <td align="center"><sub>Pictures too: generate, edit or fix on nine model families</sub></td>
  383. <td align="center"><sub>Stage the shot on a board; it becomes exact directions or a previs clip</sub></td>
  384. </tr>
  385. <tr>
  386. <td width="50%"><img src="docs/images/characters.png" alt="Characters: Tess and Theo, and Train your own with Train a LoRA (free on your PC) and Make a RefMod"></td>
  387. <td width="50%"><img src="docs/images/training.png" alt="Training a character: the recipe presets, and where it trains: free on this PC, RunPod or Modal"></td>
  388. </tr>
  389. <tr>
  390. <td align="center"><sub>Recurring characters, ready-made or your own</sub></td>
  391. <td align="center"><sub>Train free on your PC, or rent a cloud GPU</sub></td>
  392. </tr>
  393. <tr>
  394. <td width="50%"><img src="docs/images/loras.png" alt="LoRAs: a model bar for every family, and a Civitai search for paint styles shown as tall picture cards"></td>
  395. <td width="50%"><img src="docs/images/lora-details.png" alt="A LoRA's pop-up: Rough Sketch Nature's example clips, maker, trigger words, licence, file and tags"></td>
  396. </tr>
  397. <tr>
  398. <td align="center"><sub>LoRAs for every model, found on Civitai</sub></td>
  399. <td align="center"><sub>Every LoRA's examples, trigger words and licence</sub></td>
  400. </tr>
  401. <tr>
  402. <td width="50%"><img src="docs/images/voices.png" alt="Voices: Tess's and Theo's voices with their waveforms, each given to a character, and a voice designer"></td>
  403. <td width="50%"><img src="docs/images/music.png" alt="Music: MiniMax Music 3 or ACE-Step, a style and lyrics with sections"></td>
  404. </tr>
  405. <tr>
  406. <td align="center"><sub>A voice for every character</sub></td>
  407. <td align="center"><sub>Songs and scores, made on your PC</sub></td>
  408. </tr>
  409. <tr>
  410. <td width="50%"><img src="docs/images/edit.png" alt="Edit: project bin, source and program monitors, effect controls with loudness and end card, and a timeline with filmstrips and a title"></td>
  411. <td width="50%"><img src="docs/images/library.png" alt="Library: everything you made with filters for when, where from, kind, who and shape"></td>
  412. </tr>
  413. <tr>
  414. <td align="center"><sub>A Premiere-style editor, with your agent cutting alongside</sub></td>
  415. <td align="center"><sub>Everything you've made, in one place</sub></td>
  416. </tr>
  417. <tr>
  418. <td width="50%"><img src="docs/images/workflows.png" alt="Workflows: Sequences, Sizzle, Effects, Reel, Shinobi, Replace and Rebuild as cards with their own art"></td>
  419. <td width="50%"><img src="docs/images/sizzle.png" alt="Sizzle: a wall of flames behind the web address bar, centered on its stage"></td>
  420. </tr>
  421. <tr>
  422. <td align="center"><sub>Seven tools for after a render</sub></td>
  423. <td align="center"><sub>Sizzle: a website, made into a promo film</sub></td>
  424. </tr>
  425. <tr>
  426. <td width="50%"><img src="docs/images/reel.png" alt="Reel: beat bars and a drop bar for pictures and a song, then numbered steps and the Your reel card"></td>
  427. <td width="50%"><img src="docs/images/cloud.png" alt="Cloud: render on this PC or the cloud, RunPod, Modal or Comfy Cloud, a guided setup, the RunPod account and the GPU choice"></td>
  428. </tr>
  429. <tr>
  430. <td align="center"><sub>Reel: pictures and a song, cut to the beat</sub></td>
  431. <td align="center"><sub>No big GPU? Render on your own cloud account</sub></td>
  432. </tr>
  433. <tr>
  434. <td width="50%"><img src="docs/images/settings.png" alt="Settings: a section index, and Your PC with the four speed presets"></td>
  435. <td width="50%"><img src="docs/images/setup.png" alt="Settings → Setup: a ready status card with Restart ComfyUI, and folding sections for models, node packs and optional tools"></td>
  436. </tr>
  437. <tr>
  438. <td align="center"><sub>Settings, one card per topic, with speed presets</sub></td>
  439. <td align="center"><sub>Setup checks and downloads what ComfyUI needs</sub></td>
  440. </tr>
  441. </table>
  442. ## What you need
  443. - **Windows 10 or 11** (64-bit), **64-bit Linux** (the AppImage, from 0.2.8; see [Linux](#linux)), or a **Mac**
  444. with macOS 12 or newer, Apple Silicon or Intel (from 0.3.2; it renders in the cloud, see [Mac](#mac)).
  445. - **An NVIDIA GPU, or the cloud.** 24 GB of VRAM is what IV Studio is tested on (an RTX 4090); 16 GB works
  446. with smaller previews and finals. 64 GB of system RAM is recommended. Without a suitable card, nearly
  447. everything can render on a cloud GPU in your own RunPod or Modal account, voices included (see
  448. [Cloud](#cloud)).
  449. - **[ComfyUI](https://github.com/comfyanonymous/ComfyUI)**, version 0.33 or newer, running on the same PC.
  450. IV Studio talks to it at `http://127.0.0.1:8188` (change it in Settings → ComfyUI; `localhost:8000` for the
  451. ComfyUI Desktop app is fine, and Check my PC finds a ComfyUI on another usual port by itself). It can start ComfyUI for you: it
  452. finds your ComfyUI shortcut, the ComfyUI Desktop app or a portable install's `run_nvidia_gpu.bat` (or you pick one
  453. in Settings → ComfyUI, or pick your ComfyUI folder and the start file in it), starts it when IV Studio opens, and
  454. offers **Start ComfyUI** whenever it isn't running. **No ComfyUI yet?** On Windows with an NVIDIA card,
  455. Settings → Setup → **Get ComfyUI for me** downloads ComfyUI's official portable build (about 2 GB, its own Python
  456. inside, nothing else installed) into a folder you choose, checks it against the checksum ComfyUI publishes,
  457. unpacks it and starts it. It picks the build for your card (the CUDA 12.6 one for 10-series and older) and says
  458. if your driver needs updating first.
  459. - **Disk space.** About 60 GB for the H3 models. Music adds about 14 GB (MiniMax Music 3) or 10 GB
  460. (ACE-Step); voices add about 12 GB. Each is a one-click download inside the app.
  461. - **Optional:** [Ollama](https://ollama.com) for the free local prompt writer;
  462. [Fizgig](https://github.com/shootthesound/Fizgig) to train characters on your own graphics card (16 GB or more);
  463. and a [RunPod](https://www.runpod.io) or [Modal](https://modal.com) account for cloud rendering and training.
  464. ## Install
  465. 1. [Download `IV-Studio-Setup.exe`](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-Setup.exe)
  466. (about 180 MB).
  467. 2. Run it. The installer isn't code-signed yet, so Windows may show **"Windows protected your PC"**.
  468. Click **More info → Run anyway**. It installs for your user only; no admin rights needed.
  469. 3. Open IV Studio. On first launch **Check my PC** reads your graphics card, memory and drives (nothing
  470. leaves your PC), says what it can do, and sets previews, finals, the prompt writer and the downloads to
  471. suit; it ends by offering a two-minute tour of the app. IV Studio starts ComfyUI for you when it can.
  472. Before your first MiniMax H3 render it asks you to read and agree to the [terms of use](TERMS.md) once.
  473. 4. **Settings → Setup** checks ComfyUI, your GPU, the node packs and every
  474. model, installs missing node packs into ComfyUI with one click (restart ComfyUI afterwards), and
  475. downloads missing models straight into ComfyUI's models folder (each checked against the SHA-256 its
  476. host publishes). Its **Updates** row keeps ComfyUI, its node packs and ComfyUI-Manager up to date.
  477. 5. For voices, open **Audio → Voices** and press **Set up voices** once. For music, open
  478. **Audio → Music** and download the engine you want.
  479. Your projects, voices and songs are kept in `%APPDATA%\IV Studio`; renders are saved in ComfyUI's
  480. output folder under `H3\`.
  481. ### Linux
  482. 1. [Download `IV-Studio.AppImage`](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio.AppImage)
  483. (about 240 MB), make it executable (`chmod +x IV-Studio.AppImage`) and run it. AppImages need FUSE
  484. (`libfuse2`, called `libfuse2t64` on Ubuntu 24.04).
  485. 2. IV Studio finds a ComfyUI folder in your home folder (or pick it in Settings → ComfyUI) and starts it with
  486. a `.sh` script beside it, or with its `main.py` and the folder's own `venv` Python. ComfyUI's output goes to
  487. `comfyui.log` in IV Studio's data folder, `~/.config/IV Studio`.
  488. 3. Saving API keys (Civitai, RunPod, Comfy.org) needs a keyring (GNOME Keyring or KWallet).
  489. 4. Shinobi, previs and website capture use Google Chrome, Chromium or Microsoft Edge.
  490. What's different: DLSS 5 is Windows-only, so finals use a 2× AI upscale (Real-ESRGAN) and RIFE frame
  491. interpolation when those are installed in your ComfyUI, as in the cloud. The Linux build is built and checked on
  492. GitHub's Ubuntu machines (every page, the agent server, Shinobi and website capture); renders on a Linux GPU
  493. haven't been tried yet. In Settings → Agents, the command for Claude Code or Codex runs a small script that opens
  494. the AppImage, so it keeps working after updates.
  495. ### Mac
  496. A Mac has no NVIDIA graphics card, and MiniMax H3 needs one, so on a Mac IV Studio is the studio and the cloud is
  497. the GPU: shots, hunts, finishes and sequences render on your own [RunPod](#on-runpod) or [Modal](#on-modal)
  498. account, or on [Comfy Cloud](#on-comfy-cloud).
  499. 1. Download the `.dmg` for your Mac: [Apple Silicon (M1 and newer)](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-mac-arm64.dmg)
  500. or [Intel](https://github.com/hollisorg/iv-studio/releases/latest/download/IV-Studio-mac-x64.dmg). Open it and drag
  501. IV Studio into Applications.
  502. 2. The app isn't signed with an Apple Developer ID yet, so the first time macOS says it can't check it. Open
  503. **System Settings → Privacy & Security**, scroll down and click **Open Anyway** next to IV Studio (once).
  504. 3. Open the **Cloud** page (the Dashboard and the title bar point there) and set up RunPod, Modal or Comfy Cloud.
  505. What's different on a Mac:
  506. - **Renders:** in the cloud. Finals there use a 2× AI upscale (Real-ESRGAN) and RIFE frame interpolation in place
  507. of DLSS 5, which is Windows-only.
  508. - **Pictures and music** need a ComfyUI with their models: Comfy Cloud, or a ComfyUI on your Mac (IV Studio
  509. finds and starts the ComfyUI Desktop app, `ComfyUI.app`, or a ComfyUI folder in your home folder). Note that
  510. the ComfyUI Desktop app listens on port 8000: set `http://127.0.0.1:8000` in Settings if you use it.
  511. - **Voices** run on your Mac's processor, not a GPU, so they're slow; not yet tried on a real Mac.
  512. - **Updates:** IV Studio installs its own updates on a Mac too. macOS's built-in updater needs a paid Apple
  513. signature, so IV Studio downloads the new version itself, checks it against the release's checksum, swaps it in
  514. when you click **Restart to update** (or quit) and opens again. That needs IV Studio in your Applications folder:
  515. a copy opened straight from the `.dmg` or from Downloads says so and opens the download page instead.
  516. Copies before 1.1 still open the download page once.
  517. - **Keys** (RunPod, Civitai, Comfy.org) are kept in the macOS Keychain.
  518. - **Your data** is kept in `~/Library/Application Support/IV Studio`; exported edits go to `Movies/IV Studio`.
  519. - **ffmpeg** in the Mac app is Martin Riedl's GPL static build of FFmpeg 9.0.2 (the npm package's Mac builds are
  520. made with `--enable-nonfree` and can't be shared).
  521. The Mac app is built and checked on GitHub's Apple Silicon and Intel machines (every page, the agent server,
  522. edit export, Shinobi and website capture with Chrome). It hasn't been tried on a person's Mac yet.
  523. **Updates.** From 0.2.1 on, IV Studio checks for a new version when it starts and every six hours, and
  524. downloads it in the background. Click **↻ Update to …** at the bottom of the sidebar (or **Restart to
  525. update** in Settings → Updates) to install it and reopen; otherwise it installs the next time you quit.
  526. It waits while an edit is exporting or models are downloading. Coming from 0.2.0 or older, install 0.2.1
  527. by hand once.
  528. The portable Windows copy updates itself the same way from 1.1.2 on: it downloads the new portable zip into
  529. its data folder, checks it, and swaps the program files in place, keeping the data folder. A portable copy on
  530. 1.1.1 or older needs the 1.1.2 zip unzipped over it once.
  531. <p align="center">
  532. <img src="docs/images/setup.png" alt="Settings → Setup: a ready status card with Restart ComfyUI, and folding sections for models, node packs and optional tools" width="100%">
  533. </p>
  534. ## Dashboard
  535. IV Studio opens on the **Dashboard**: one-click starts for a shot, a picture, a short film, an edit, a song,
  536. a voice line, a website film or a new character; your most recent renders; and your cast, each with their
  537. face, their voice, and **New shot** to start a shot with them already picked. After an update, a strip at the
  538. top says what's new in that version (Settings → Updates keeps the last few).
  539. Every page opens on its own banner, drawn in the Infinite Variance eye style: a clapperboard for Shots,
  540. scissors for Edit, a storm cloud for Cloud, a record player for Music, and so on. On wide windows the art
  541. stays against the right edge.
  542. ## How a shot works
  543. 1. **Create.** Pick a mode, a character and write the shot.
  544. - **Text:** just the prompt.
  545. - **References:** pictures, videos or audio guide the shot (`<Picture 1>`, `<Video 1>`, `<Audio 1>`).
  546. Click a reference to crop or trim it; videos snap to H3's lengths. **Size: Fit for H3** resizes a
  547. picture or video to H3's own sizes (about 0.5, 1 or 2 MP, both sides on a 32-pixel grid, video at
  548. 24 fps), which some modes, like Retake, need.
  549. - **First / last frame:** the clip opens on a picture and can end on a second one.
  550. - **Continue a video:** carries a clip on from its last frames. Hunt 1 to 3 takes like any shot; the
  551. finish refines the picked take at full size and joins the source back on, so the final is the whole
  552. continued video.
  553. Create is laid out as numbered steps (what kind of shot, who's in it, what it builds on, what happens,
  554. shape and size) beside a pinned **Your shot** card that shows the frame in its shape and the Hunt button.
  555. At the top, pick the model: **MiniMax H3** on this PC (free) or **Seedance 2.5** on your Comfy.org credits
  556. (see [Seedance 2.5](#seedance-25)). For H3, a **Speed** preset sets the preview size, steps, takes and the
  557. finish together: Quality, Balanced, Fast or Low memory (Check my PC picks one for your card).
  558. Set the aspect, length, preview size and how many previews to hunt (1 to 3). Optional extras: a voice
  559. line to lip-sync, RefMods and LoRAs (both in **Who's in it**), and under **Advanced** the steps, sampler and
  560. scheduler (from your ComfyUI's own lists; er_sde and beta by default).
  561. 2. **Hunt.** IV Studio queues the previews on ComfyUI and shows them as they finish.
  562. 3. **Pick and finish.** Choose a preview and set the final size (1, 1.5 or 2 MP), the enhancer and the
  563. sound source. The finish starts from the preview's own latent, so the motion stays the same.
  564. - **DLSS 5** (the default): RTX 2× upscale and frame generation (30/50/60/120 fps), seconds per shot.
  565. - **SeedVR2** (3B): restores face, eye and hair detail and upscales to 1080p, 1440p or 2160p, on any
  566. NVIDIA card. **Enhance** runs either one again on a finished shot.
  567. Picking a take opens the Finish settings over the page. DLSS 5 has a **strength** (its noise reduction:
  568. higher adds contrast and skin texture, lower stays closest to the take) and a look (Default, Natural,
  569. Cinematic); SeedVR2 has **extra detail** (0 restores faithfully; more redraws more, smoothing skin and
  570. changing faces a little). Every final and enhanced copy sits in one
  571. **Finished versions** card. **Compare** plays up to four takes, finals or copies in sync: side by side, as a
  572. wipe or in a grid, zoomed in on the same spot, with frame-by-frame stepping.
  573. From any finished version, **Continue from this** opens a new Continue shot with it as the source (same
  574. character, LoRAs and shape), and **Use the last frame** saves its final frame as a picture in the Library,
  575. to start a new shot from it as the first frame or to change it in Create → Image first.
  576. 4. **Shots.** Every shot keeps its runs, previews and finals. **Show in folder** opens the file. The Shots page
  577. groups them by the day you last worked on them (older ones by month; each day's heading stays at the top as
  578. you scroll and folds away with a click) and filters them by status, when, kind of shot, who's in it and
  579. shape, in a panel that folds away. Tiles load their video only as they come near the screen, so a long
  580. history opens at once.
  581. ### Seedance 2.5
  582. The model switch in Create also runs ByteDance's **Seedance 2.5** through ComfyUI's partner nodes, billed to
  583. your Comfy.org credits (add your key in **Settings → Comfy account**; your balance shows there and in the title
  584. bar). It's the same Create page: text, references, first/last frame or continuing a clip, 4 to 30 seconds.
  585. - **Quality.** Draft (480p) takes are cheap: try a few, then finish the one you like. Or make 720p or 1080p
  586. takes straight away.
  587. - **The price first.** The Hunt button shows ComfyUI's own price for the takes, and a confirmation asks before
  588. anything is charged. Paid finishes ask too.
  589. - **Writing.** **Write it for me** follows a Seedance 2.5 prompt guide: references are named `@image1`,
  590. `@video1`, `@audio1` and each gets a job; a character comes along as their face picture.
  591. - **Finishing a take.** Seedance 1080p (paid), or free on this PC: SeedVR2 (cleanest, about 4 minutes for
  592. 5 seconds), DLSS 5 (about 15 seconds), H3 + DLSS 5 or H3 + SeedVR2 (H3 redraws it at full size first; faces
  593. change a little), or keep the take as it is.
  594. ### Before and after a render
  595. - **Prompt checker.** Before a hunt, IV Studio checks the prompt the way H3 reads it: the real length on
  596. H3's frame grid, blank fields, the opening line a mode needs, cut times, too many words for the seconds,
  597. quotes and speaker names around spoken lines, references named but not attached, a LoRA character's face
  598. described in words, filler words and unknown @ names. Most findings have a **Fix**; errors hold the hunt
  599. until you fix them or choose **Render anyway**.
  600. - **@ mentions.** Type @ for your cast and places. The picked character becomes `{char}`; anyone else with a
  601. picture is attached as a reference, and a text shot switches to References mode by itself.
  602. - **Draft or Standard.** Draft previews take 4 steps instead of 8, roughly 40% faster, for hunting ideas.
  603. - **Live previews.** Each take's step pictures stream to the page while it renders (H3's tiny decoder
  604. through KJNodes), so a bad take shows itself in about 20 seconds. **Live preview** (above the Library
  605. button) floats the running render over every page: drag it to any corner, resize it, or fold it to a pill.
  606. - **Ranked takes.** When a run finishes, the takes are scored: the spoken words Whisper hears back, likeness
  607. to the character (InsightFace), no frozen stretches and sharpness. The best is marked only when it clearly
  608. leads, with the reasons in words, and every pick you make tunes the weights.
  609. - **Runs as versions, and Compare.** Each run shows what changed since the last, the prompt as written and as
  610. rendered, and a word diff. **Compare** plays two takes side by side or as a wipe, in step. **Edit and run
  611. again** renders into the same shot.
  612. - **Review a take.** Your prompt writer watches six frames of a take (and reads what Whisper heard), names
  613. each problem with its seconds, says what works and picks one fix: revise the prompt, change a reference,
  614. split the action, use a clean stretch, or fix it in the edit. It remembers the shot's earlier reviews, so
  615. a problem that came back after a rewrite gets a different kind of fix.
  616. - **Staging board.** A top-down floor with up to four people (where they face, who they look at, where they
  617. walk) and the camera (lens, height, ten moves). It becomes exact screen-side directions in the prompt, and
  618. warns when a cut crosses the 180-degree line. For arcing moves, **Make a previs clip** renders the board in
  619. motion as a grey clip that H3 follows as `<Video 1>`.
  620. The directing rules the writers and the review follow (purpose first, staging by screen side, no padding,
  621. frame the action) are Matthew Hollis's own method, built into `src/service/directing.js`.
  622. ### Write it for me
  623. You don't need to know H3's prompt format. Type the idea in plain words, for example "Tess in a parked
  624. car at night admits she kept the letter", and press **Write my prompt**. You get a finished H3 prompt
  625. back to edit, keep or undo. It always uses your mode, length, aspect, character and media. Choose the
  626. writer under **Settings → Prompt writer**:
  627. - **Local (free):** a model in Ollama on your PC with IV Studio's H3 rule sheet. The recommended model is
  628. `huihui_ai/qwen3-vl-abliterated:8b-instruct` (about 6 GB, one click to install), huihui-ai's uncensored
  629. copy of Qwen3-VL 8B Instruct (Apache-2.0), so it doesn't refuse mature ideas. Any other Ollama model works
  630. too, including the original `qwen3-vl:8b-instruct`. While ComfyUI is rendering it runs on the CPU, so it
  631. never takes H3's VRAM. Ollama somewhere else (another container or PC) works too: set **Ollama address**
  632. in Settings → Prompt writer (or `OLLAMA_HOST`), like `192.168.1.20:11434` or `http://ollama:11434`.
  633. **It looks before it writes.** Add your references first: the writer is shown your reference pictures,
  634. two frames of each reference video, your first and last frames, and the last frame of a video you're
  635. continuing (up to six images, labelled `<Picture 1>`, `<Video 1>` and so on), and writes what it sees.
  636. It tells you what it will look at, or that the model you chose can't see pictures.
  637. - **OpenAI-compatible:** any server that speaks the OpenAI API (`/v1/chat/completions`): llama.cpp's
  638. `llama-server`, llama-swap, vLLM, LM Studio, LiteLLM, LocalAI, or OpenAI itself. Enter the address (like
  639. `localhost:8080`; `/v1` is added when there's no path) and the model name, and turn on **It can see
  640. pictures** for a vision model. An API key and extra headers are optional and stored encrypted. It writes
  641. exactly as the local writer does, asking for structured JSON (`json_schema`, falling back to `json_object`
  642. or plain text for servers without it). IV Studio doesn't load or unload its models: with llama-swap, the
  643. model name picks what it loads. Agents using the MCP server pass the key as `IV_STUDIO_LLM_KEY` (or
  644. `OPENAI_API_KEY`) and headers as `IV_STUDIO_LLM_HEADERS`.
  645. - **Claude Code, Codex or Hermes:** if you have one installed and signed in, it writes with your own login,
  646. headless and with no tools but reading your reference pictures (Hermes, from 1.1.7, on the model you picked in
  647. Hermes; it sees your pictures when that model can). It gets MiniMax's own H3 prompt guide
  648. (downloaded from MiniMax on first use, not shipped) and the full directing method.
  649. - **MiniMax Context IR:** MiniMax's own prompt rewriter through ComfyUI, paid through your Comfy.org
  650. account (about $0.02 to $0.11 a prompt). Your API key is stored encrypted on your PC.
  651. ## Projects: a short film in six steps
  652. **Projects** turns an idea into a finished short film, one step at a time, with a storyboard you can see.
  653. 1. **Idea.** What it's about, the format (16:9, vertical or square) and the length.
  654. 2. **Story.** **Write it for me** drafts a script from the idea, cast and length with your prompt writer (Settings → Prompt writer:
  655. the local model, Claude Code, Codex, Hermes or an OpenAI-compatible server), or
  656. write it in plain words, or bring a `.txt` or `.fountain` screenplay.
  657. 3. **Cast and places.** Speakers are played by your characters. Someone you made up gets a face drawn from
  658. their description, or from your own picture, and keeps it in every shot. Places get a description and a
  659. picture (drawn for you if you have none), plus **More angles** (a quarter turn, the side and a wide view,
  660. drawn with the QMA camera-angles LoRA for Qwen Image 2.1). Pick the film's look from six styles or your
  661. own words and LoRAs, add **Cinematography** (film stocks, lenses, lighting setups, camera rigs, moods: 165
  662. ready phrases, each shown as a picture), and make a **Lookbook**: name a film, director or cinematographer, or describe the look,
  663. and your writer turns it into look language with no names in it. All of it goes into every shot.
  664. 4. **Storyboard.** The writer plans each scene into 3 to 10 second shots with staging and where each one
  665. ends, writes each H3 prompt, and every panel gets a sketch that keeps your characters' faces and the
  666. room. Open a panel to change the action, camera, speaker, line or length, draw it on the staging board,
  667. use a recording of the line, or carry straight on from the shot before in one take. **Play the
  668. animatic** shows the whole film as sketches with the lines spoken.
  669. - **Coverage.** Cover a scene with one of twelve coverage plans: full coverage, dialogue coverage (a
  670. wide master, a matched over-the-shoulder pair, a matched close-up pair and a listening reaction),
  671. motion, extreme action, an establishing sequence, surveillance, an entrance, parallel action, a dance,
  672. angle coverage, an orbit or story beats. The planner then makes exactly those shots, each named by its
  673. slot.
  674. - **Check continuity** reads a scene's shots like a script supervisor (looks and wardrobe, props, light,
  675. time of day, weather, screen sides and eyelines, and how each shot ends against the next) and gives a
  676. concrete fix for each mismatch.
  677. - **Prompt tools** on every shot: a director's note in plain words ("make it colder, she shouldn't
  678. smile"), **Tighten**, **Enrich**, **Distill**, **Stronger shot**, **New angle** and **3 variants** to
  679. compare. Spoken lines, labels and sections are kept, and every earlier prompt stays in the shot's
  680. history to go back to.
  681. - **Shot list**: save it as a Markdown document or as CSV for a spreadsheet.
  682. The setups and coverage plans come from **Slate, the prompt studio for AI filmmaking, by Sam Wasserman**
  683. (wassermanproductions.com, Apache-2.0), through Imagination Studio by keys + Wasserman. They ship
  684. unchanged in `resources/slate/` with Slate's notice.
  685. 5. **Film it.** Every panel is filmed from its sketch (2 or 3 takes), in References mode with the place's
  686. picture and the faces on screen, so the room and the people hold. Lines are spoken first in each
  687. character's own voice and read back with Whisper until the words match. Pick a take, and it finishes at
  688. 2 MP.
  689. 6. **Watch.** The takes play in order; **Save the film as a video** exports the rough cut, and **Fine-tune in
  690. the editor** opens it in Edit.
  691. ## Images
  692. **Create** switches between **Video** (a shot) and **Image** at the top. Image makes pictures on your PC with
  693. the image models you have in ComfyUI:
  694. | Family | Generate | Edit | Licence |
  695. |---|---|---|---|
  696. | Flux.2 Klein 9B | ✓ | ✓ several reference pictures | FLUX Non-Commercial (9B) |
  697. | Flux 3 Klein | ✓ | ✓ | FLUX Kommunity |
  698. | Krea 2 | ✓ | ✓ with the Krea 2 Identity Edit LoRA and the comfyui-krea2edit nodes | see Krea 2's model page |
  699. | Moss | ✓ | needs a newer ComfyUI | Apache-2.0 |
  700. | Qwen Image 2.1 | ✓ | ✓ up to three references | Apache-2.0 |
  701. | Z-Image Turbo | ✓ | ✗ | Apache-2.0 |
  702. | SDXL (and any SDXL fine-tune: Juggernaut, RealVis, Pony, Illustrious…) | ✓ | ✗ | CreativeML Open RAIL++-M (base); fine-tunes have their own |
  703. | MiniMax H3 (a still) | ✓ with your H3 character LoRAs | ✗ | MiniMax H3 Community License |
  704. **Getting a model (1.1.3).** A family you don't have yet says *not set up*. Click it to see the files it needs,
  705. which of them you already have, and one button that downloads the rest into ComfyUI (pinned versions, each
  706. checked against its published SHA-256). The same files are under Settings → Setup → Optional tools → Picture
  707. models. Your own builds and fine-tunes count: a Moss or Krea 2 fine-tune in its own folder makes that family
  708. ready. Flux.2 Klein 9B and Flux 3 Klein are gated: accept their licence on Hugging Face, then save a Read token
  709. in that panel or on Setup (or log in with `hf auth login`).
  710. SDXL checkpoints go in ComfyUI's `models/checkpoints`; Setup offers SDXL base 1.0 as an optional download. An
  711. H3 still is one frame from the middle of a very short H3 render (8 steps with the turbo LoRA), so it has the
  712. look of your shots and can star your trained characters; it uses the H3 models you already have.
  713. Pick **Generate** or **Edit**; Edit lists only the families that can. Pick a family and one of its
  714. checkpoints (your fine-tunes are there too), add that family's LoRAs from the same picker as Video's, then
  715. the size, how many (1 to 4) and a seed. Each graph follows ComfyUI's official template for its model.
  716. Finished pictures appear under the form and in the **Library**. Open one to **Use in a shot** (it becomes the
  717. shot's first frame), **Edit this**, **Add to edit**, **Make more like this** or **Show file**. Agents use
  718. `list_image_models` and `make_image`.
  719. ## Characters
  720. A character is a trained MiniMax H3 LoRA plus its trigger word, or a RefMod; write `{char}` in the prompt
  721. where the character goes. On the **Characters** page:
  722. - **Your characters:** portrait cards; click one for its trigger, strength, LoRA or RefMod (checked against
  723. ComfyUI) and voice. **Add from a LoRA or RefMod** adds one you already have.
  724. - **Ready-made:** IV Studio's own invented characters, Tess Marlow and Theo Lindqvist. Download one and
  725. its LoRA (about 150 MB, from this repo's `characters-v1` release, checked against its SHA-256) goes into
  726. ComfyUI, and their bundled voice comes with them.
  727. - **Make a RefMod:** up to six pictures (and a voice clip) become a RefMod character on your PC in seconds,
  728. with no training (ComfyUI-MiniMaxH3Mod's RefMod extractor). It works in Create's shots.
  729. - **Train a LoRA,** the method that made Tess, for the best likeness:
  730. 1. **Design:** describe the face; Z-Image Turbo renders four candidates on your PC. The one you pick is
  731. rendered in eight scenes on the same seed. Or add your own pictures, only of an invented person or
  732. someone who agreed.
  733. 2. **Clips:** H3 renders talking clips from the stills and the character's voice, or you add your own.
  734. Everything is fitted to Fizgig's rules (24 fps, 17n+5 frames, 32 kHz stereo).
  735. 3. **Train:** with [Fizgig](https://github.com/shootthesound/Fizgig), where you choose:
  736. - **This PC, free:** on your own NVIDIA card with 16 GB or more. A Standard run is a few hours; when
  737. Check my PC finds a card that can, the page says **Free on your PC** and the Train step starts there.
  738. - **RunPod or Modal:** your own account, by the second, with the minutes and dollars shown first. Theo
  739. took 56 minutes and about $4.10 on an H200. On RunPod, IV Studio makes an 80 GB storage volume (kept
  740. for later runs) and a training pod that deletes itself when the run is done.
  741. The recipe: Quick, Standard or Thorough; look and voice, or look only; normal or fine detail; the person
  742. or their whole look; how many checkpoints; and, under Advanced, rank, epochs, seed, caption dropout,
  743. schedule and base precision. A **spending cap** stops a cloud run at your budget and keeps what it saved.
  744. **Train more** carries a finished run on from its last saved state.
  745. 4. **Pick:** checkpoints are rendered side by side on one seed, and **Score them for likeness** marks the
  746. closest; the one you choose becomes a character, keeping the voice its clips were made with.
  747. **Likeness:** with InsightFace's face models (a one-time 289 MB download; non-commercial licence), IV
  748. Studio scores every still and clip against the picked face and can keep the closest of each scene.
  749. ## LoRAs
  750. **LoRAs** (on the Visual side) changes how H3 looks and moves: styles, motion, camera, speed.
  751. - **Discover** searches [Civitai](https://civitai.com)'s MiniMax H3 LoRAs: tall cards whose preview fills
  752. the card and plays on hover, filters (style, concept, cinematic, motion, camera, effect, speed, tool) and
  753. sorting. Open one for a pop-up with a gallery of up to 16 examples (click one for a full-size view with
  754. its generation prompt and settings, when Civitai has them), the maker, versions, trigger words to copy,
  755. the licence (whether commercial use is allowed), tags and the maker's notes, then **Download**: the file
  756. goes into ComfyUI's `loras\Civitai\<model>\` folder, checked against the
  757. SHA-256 Civitai publishes. Downloading needs your own free Civitai API key (**Settings → Civitai**; it's
  758. stored encrypted on your PC). Searching doesn't.
  759. - **Yours** shows the LoRAs already in ComfyUI, grouped by folder, H3 ones first. **Find on Civitai** looks
  760. each one up by its file's SHA-256 for its name, trigger words and a preview. Star your favourites.
  761. - **Create's LoRA tray** shows the LoRAs in a shot as pictures with a strength slider; **+ Add LoRA** opens
  762. the same browser. A LoRA's trigger words go into the prompt when you add it.
  763. - **Mature LoRAs** are off. **Settings → Civitai → Show mature LoRAs (18+)** switches to civitai.red, with
  764. previews blurred until clicked; a second box, **Show mature previews without the blur**, drops the blur.
  765. LoRAs of real people and anything involving minors are never shown, in either mode.
  766. ## Voices
  767. **Audio → Voices** keeps a voice for every character, and **Audio → Lines** says anything in any of them.
  768. - **Design a voice** from a description ("a woman in her forties from Glasgow, low, warm and a little
  769. gravelly"): three takes to choose from.
  770. - **From a recording:** a clean 10 to 20 seconds of one person talking. Only your own voice, an invented
  771. one, or someone who agreed, and IV Studio asks you to confirm.
  772. - **Speak it:** in **Create**, a character with a voice gets a **Speak it** box. Type the line; it becomes
  773. the shot's voice line, and the same words go into the prompt so H3 lip-syncs them.
  774. - **Lines** keeps every line you've spoken, ready to use in a shot or drop on an edit. A new seed gives a
  775. new read of the same words.
  776. The speaking runs on your PC in IV Studio's own Python environment (set up once, about 12 GB):
  777. [VoxCPM2](https://huggingface.co/openbmb/VoxCPM2) (OpenBMB, Apache-2.0) designs, clones and speaks, and
  778. [Whisper large-v3 turbo](https://huggingface.co/openai/whisper-large-v3-turbo) (OpenAI, MIT) reads the
  779. words in a recording. A line takes about 4 seconds once the model is loaded. The voice engine is stopped
  780. before every render, so it never shares the GPU with H3.
  781. ## Music
  782. **Audio → Music** makes songs and instrumentals on your PC through ComfyUI's own nodes:
  783. - **MiniMax Music 3:** full songs up to five minutes with the clearest sung words of the open models.
  784. Describe the style and write lyrics with `[Verse]`, `[Chorus]` and other section tags; the song's length
  785. follows the lyrics. About a minute or two per song on an RTX 4090.
  786. - **ACE-Step 1.5 Turbo:** a song in seconds, with tempo, key, time signature and language. Best for drafts,
  787. background music and instrumentals.
  788. Every song is kept in IV Studio's music folder. **Add to edit** puts it on A1 of a new or existing edit;
  789. **Use in a shot** makes it the voice line, so a character sings it (trim it to the shot first).
  790. ## Sequences
  791. Several shots that play as one continuous video.
  792. - **One take:** every shot renders together in one seamless take through
  793. [H3 Multishot](https://github.com/jlucasmcrell/ComfyUI-H3-Multishot)'s sampler, so there are no cuts,
  794. colour shifts or breaks in the sound.
  795. - **Shot by shot:** hunt and pick each shot in turn; each carries on from the end of the one before.
  796. - **Retake:** mark a stretch of any version and redo the picture and sound, the picture only, or the sound
  797. only. Everything around it stays.
  798. - **Render out:** optional colour smoothing across the joins, then DLSS with RTX 2× and frame generation.
  799. Shots are 10 or 15 seconds, the lengths H3 Multishot is tested at.
  800. ## Edit
  801. An editor laid out like Adobe Premiere for cutting shots, sequences, songs and lines together. **Full
  802. screen** (or F11) hides IV Studio's sidebar and gives the whole screen to the edit; Esc brings it back.
  803. - **Panels.** Project bin, Source monitor, Program monitor and Effect controls on top, the timeline below.
  804. Drag any border to resize; the layout is remembered.
  805. - **Project bin.** Thumbnails, search, and Video, Pictures and Sound bins. Its Library tab holds every IV
  806. Studio render, song and line, one click from the edit.
  807. - **Source monitor.** Click a bin item to open it, mark In (I) and Out (O), then press , to insert it at the
  808. playhead (everything after moves right) or . to overwrite. Or drag the picture onto a track.
  809. - **Timeline.** As many video and audio tracks as you need (a higher V track plays over a lower one), plus
  810. titles. Each track can be targeted (click its name), hidden, locked, muted or soloed. Video clips show a
  811. filmstrip and their sound's waveform; sound clips show a waveform. Markers sit on the ruler.
  812. - **Tools.** Select (V), Razor (C, click to cut; the cursor becomes a red katana), Ripple trim (B, the rest of the track follows) and Rolling
  813. edit (N, moves a cut between two clips). Each clip has fades and volume; titles have their own text,
  814. size, colour, position and box.
  815. - **Export MP4** renders the timeline at 1080p, 4K, vertical or square, 24/30/60 fps, into
  816. `Videos\IV Studio\Edits`. Hidden tracks stay out of the picture and muted ones out of the sound.
  817. Keys, as in Premiere: Space play · J K L shuttle (press again to go faster) · ← → one frame (Shift: one
  818. second) · ↑ ↓ previous / next edit · I O mark · , insert · . overwrite · S split · Ctrl+K split every track ·
  819. Q W ripple trim to the playhead · Delete, Shift+Delete ripple delete · M marker, Shift+M next marker ·
  820. \ fit · = − zoom · Ctrl+Z / Ctrl+Y · F11 full screen, Esc back.
  821. **Make new footage on the timeline.** Right-click a clip or a gap:
  822. - **Extend…** carries a clip on 5, 10 or 15 seconds from its last frames.
  823. - **Bridge to the next clip…** makes a new shot from one clip's last frame to the next one's first.
  824. - **Fill this gap…** does the same across a gap.
  825. - **Retake this stretch…** redoes part of a clip: picture and sound, picture only, or sound only.
  826. Each one starts from the clip's own shot when IV Studio made it (its character, LoRAs and look), and
  827. **Write it for me** looks at the frames it starts from. A striped placeholder shows where the footage will
  828. land and how far it has got. Bridges and fills offer three takes to pick from; the result lands as a
  829. normal clip you can undo.
  830. **More on the right-click menu:**
  831. - **Cut out…** keeps only who or what you name ("the bluebird", "the man in the hat"). SAM 3.1 tracks it,
  832. and the clip comes back with see-through edges on the track above, sound kept.
  833. - **Reframe to 9:16 / 1:1 / 4:5 / 16:9…** fits a shot or picture into the edit's shape and draws what lies
  834. beyond its edges: H3's masked video edit for clips (the original picture and sound are kept), Qwen Image
  835. 2.1 with an outpaint LoRA for pictures.
  836. **Loudness.** Exports come out at Online loudness (about -14 LUFS, the default), TV (-23) or as mixed, under
  837. a -2 dBFS peak limit.
  838. **With an agent.** Your agent edits the same timeline through IV Studio's MCP server. Its changes appear
  839. at once with a strip saying what it did and a one-click Undo, and tracks you lock are off limits to it.
  840. It can make new footage on the timeline too.
  841. ## Library
  842. The **Library** button above the Visual | Audio switch opens everything you've made: shot finals and
  843. previews, sequences, Replace runs, pictures, Edit exports, songs and spoken lines, newest first. A shot's
  844. previews and finals are one tile with an "N versions" badge; click it to watch every version in a large
  845. viewer and step through them with the arrow keys. Everything sits under the day it was made (older work by
  846. month), filtered by type (videos, images, music, voice lines), when, where it came from (Shots, Sequences,
  847. Replace, Edit exports, Images, Music, Voice lines) and, for shots, their kind, who's in them and their shape;
  848. sort by newest, oldest, name, most versions or longest. Search also finds words in the prompts renders were
  849. made from. Tiles show each render's size, length and model.
  850. Open a tile to watch its versions, listed as rows with their full names. **How it was made** shows the model,
  851. kind of shot, size, length and frame rate, character, LoRAs and RefMods, seed and steps, which take it is, how
  852. it was finished and enhanced, the render time and what it cost, with the prompt it came from (**Copy**,
  853. **Show all**). Then add any of them to an edit or use a sound as a shot's voice line.
  854. Above it, the **Queue** shows what ComfyUI is rendering and what waits, on every page: each render's name,
  855. its step and time, a click to open its page, and × to cancel one of IV Studio's own. Renders an agent
  856. started show as rendering with their time, without the step count.
  857. ## Simple words
  858. New to AI video? **Check my PC** asks how much you know about making AI video and pictures, and **Settings →
  859. Words** has the same switch. With **Simple words** on, IV Studio explains itself in everyday words: a LoRA is a
  860. "trained look", a seed a "variation number", DLSS a "quick sharpen", an upscale an "enlargement", a prompt a
  861. "description", and the main help lines are rewritten in plain language. Only the words change: every page,
  862. control and setting stays the same, and names, prompts and file paths are never touched.
  863. ## Accessibility
  864. **Settings → Accessibility** makes IV Studio easier to read and use, and each change applies at once:
  865. **Colour** (Red, Blue, Purple, Orange or Dark: buttons, highlights and the artwork follow),
  866. **Text size** (Normal, Large, Larger: everything scales, like browser zoom), **Higher contrast text** (grey
  867. secondary text close to white, stronger lines; also offered on Check my PC's first page), **Reduce motion**
  868. (no animations, and the Workflows stages stand still; your system's own setting is followed too), **Clear
  869. focus outlines** (a thick yellow ring on whatever the keyboard is on) and **Underline links**.
  870. ## Incognito
  871. The **Incognito** switch in the title bar restarts IV Studio into a separate, private space, and the eye
  872. closes. Shots, sequences, edits, songs, voices and lines, characters, trainings, Shinobi films, sizzles and
  873. exports made there are kept apart (in `%APPDATA%\IV Studio\incognito`, exports in its `videos` folder) and
  874. never show in the normal app; nothing normal shows there. Your characters and saved voices come along, and
  875. settings, keys and models are shared. ComfyUI saves Incognito renders into its `output\IV Private` folder
  876. (uploads into `input\IV Private`), and leaving Incognito clears them from ComfyUI's history. Switch back
  877. the same way.
  878. **Settings → Folders → Finished videos** picks where exported films and edits, and cloud renders brought to
  879. this PC, go: any folder on any drive (`Videos\IV Studio` unless you change it; Check my PC asks too).
  880. It also picks where in ComfyUI's output folder renders save, one folder for normal renders
  881. (straight into `output` unless you name one) and one for Incognito (`IV Private` unless you change it). They
  882. can't be the same folder, and they always stay inside ComfyUI's folders.
  883. Incognito keeps things out of IV Studio's normal views. It isn't encryption: the files are on your PC, in
  884. the folders above, and LoRAs trained in Incognito land in ComfyUI's LoRAs folder like any other.
  885. ## Workflows
  886. Seven tools for what comes after a render: Sequences, Sizzle, Effects, Reel, Shinobi, Replace and Rebuild. Each
  887. opens on its own animated stage with its main bar centered (a wall of fire for Sizzle, a beat for Reel, running
  888. film for Sequences, blade cuts for Shinobi, a scanning swap for Replace), then works in numbered steps; the
  889. stages pause when they're off screen and stay still if your system asks for reduced motion. Sequences is
  890. described [above](#sequences), and Effects in [what's new in 1.1](#whats-new-in-11).
  891. **Rebuild** takes a video you made apart and remakes it: IV Studio reads it shot by shot, your agent (Claude Code
  892. or Codex) plans how each shot is remade, you approve the plan and the frames, H3 renders the new shots on this PC,
  893. and a first cut lands in Edit beside the original.
  894. ### Sizzle
  895. Put in a web address and get a short promo film for it.
  896. 1. **Capture.** IV Studio opens the site in your PC's Edge or Chrome (hidden) and saves what people see: a
  897. screenshot of every screen down the page, the phone layout and the logo, plus the site's words, colours,
  898. fonts and pictures. Cookie banners are hidden, never accepted.
  899. 2. **Storyboard.** Your agent writes the scenes from the capture: the site's own screens, H3 shots,
  900. Z-Image pictures, titles from the site's copy, music and an optional voice-over. Nothing renders until you
  901. approve it.
  902. 3. **Pieces.** H3 shots (previewed, then finished at 1 MP), pictures, music and the voice-over are made on
  903. your PC: about 3-5 minutes per H3 shot.
  904. 4. **The film.** **Cut it for me** puts everything in a Shinobi project and cuts a first version: cuts on
  905. the music's beat, the site's screens with slow push-ins, two-tone titles in its colours, and an end card
  906. on the logo, the main button's words and the web address, ending where the music ends. It renders in
  907. about 2-3 minutes. Your agent can then refine it in Shinobi (the site's own fonts, pans, effects).
  908. The Sizzle page shows the capture, the storyboard with each scene's piece, and the finished film, with a
  909. message to paste into your agent. Agents use the `sizzle_*` tools.
  910. ### Reel
  911. Pictures or clips plus a song become a new edit cut to the beat: a whole number of beats per picture (calm,
  912. normal or fast), cuts counted in bars from the first beat, a slow push, drift or pull on each picture, in
  913. 16:9, 9:16 or square. The beat is found with the bundled FFmpeg alone, within a few milliseconds on click
  914. tracks.
  915. ### Replace
  916. Puts your characters into a video, or changes the scene around the people in it, while the camera, cuts,
  917. motion and soundtrack stay:
  918. - **Swap people:** one or two characters (your presets, Tess and Theo, or any picture) take the place of
  919. whoever you describe: face, hair, body and clothes. A preset's LoRA can join the run.
  920. - **Change the scene:** in plain words: remove or add things, or change the weather, light, setting or style
  921. ("a snowy winter evening", "remove the wind turbines").
  922. - **Finish:** redraw small faces at close-up size, or soften H3's look.
  923. It runs on [Viggle Remake](https://huggingface.co/Viggle/Viggle-Remake), two LoRAs on MiniMax H3 (swap and
  924. edit), up to 14 s at a time. IV Studio does the parts Viggle leaves to a person:
  925. 1. it puts the source on Remake's canvas (24 fps, its own shape, the frame count H3 needs) and finds the shots;
  926. 2. it paints a frame of each shot the way the result should look, with Qwen Image 2.1 edit on your PC. A swap's
  927. frames are checked with the face model (nobody added, and it looks like your character) and painted again
  928. when they fail; then you check them (paint one again, use your own picture, or leave one out);
  929. 3. your prompt writer (local, Claude Code or Codex) writes Remake's six-section prompt from the source and the
  930. painted frames, following Viggle's own guide, and IV Studio checks it;
  931. 4. Remake renders 1 to 3 takes (about 2.5 minutes for 5 s on an RTX 4090), trimmed back to the source.
  932. In the editor, right-click a clip → **Remake this clip…**. Setup downloads the two Remake files (21 GB each)
  933. and installs Viggle's nodes. Powered by Viggle Remake; the weights are under the MiniMax H3 Community License.
  934. The old engine, [OpenJutsu](https://github.com/D3voz/openjutsu)'s mask workflows (MIT, commit `47c3724`), is
  935. still there behind **Use the old engine** at the foot of the page for one more version; it runs Finish.
  936. ### Shinobi
  937. IV Studio's agent-driven editor. Where **Edit** is cut by hand, Shinobi lets an agent (or a one-click recipe
  938. from 12 styles) author the whole edit in code: cuts on the beat, speed ramps, punch-ins, typography, masks,
  939. captions from speech and sound cues. It renders on your PC with the Edge or Chrome you already have.
  940. Shinobi's engine is [OpenKatana](https://github.com/rk0neki/OpenKatana) (Apache-2.0), installed unmodified;
  941. Shinobi isn't affiliated with OpenKatana or with Higgsfield, whose Katana inspired it.
  942. ## Help on every page
  943. <p align="center">
  944. <img src="docs/images/tour.png" alt="How it works: the Create tour lighting up What happens, with its card and Next" width="100%">
  945. </p>
  946. Every page has a **How it works** button by its title (and in the editor's top bar). Click it and the page
  947. walks you through itself: each part lights up in turn with a line about it, and Next, Back, the arrow keys or
  948. Esc move through it. The button glows until you've taken that page's tour once. Steps follow the page as it
  949. is, so Create's tour includes the reference step only in the modes that take references.
  950. The welcome wizard (**Check my PC**) ends by offering a **full tour**: about two minutes across the whole app,
  951. ending on the How it works button. Take it again from Settings → About, where the PDF guide is too. After an
  952. update, **What's new** shows on the Dashboard once.
  953. ## How IV Studio uses ComfyUI
  954. IV Studio is a front end for your own ComfyUI; every picture, video and song is a ComfyUI job.
  955. - **The API.** It queues graphs with ComfyUI's HTTP API (`/prompt`, `/upload/image`, `/history`, `/view`,
  956. `/object_info`, `/free`) and follows progress on its websocket, including KJNodes' live step previews.
  957. Before a render it checks `/object_info` for every node and model the graph needs.
  958. - **Graphs built in code.** Each workflow is assembled per job from the user's choices in `src/service/`
  959. (`studio.js` for shots, `images.js`, `music.js`, `reframe.js`, `editgen.js`, `productions.js` and more),
  960. following ComfyUI's official templates for each model. The H3 hunting graph is checked against its
  961. ComfyUI GUI export in 32 switch states (`test/graph-parity.mjs`).
  962. - **Workflow files.** `resources/workflows/iv_studio_api.json` is the full IV Studio H3 workflow in API
  963. form (with `iv_studio_api.groups.json`, its switch groups), and `resources/workflows/replace/` holds the
  964. Replace's old-engine workflows from OpenJutsu. Load them in ComfyUI to see the graphs IV Studio drives.
  965. Remake's graph is Viggle's own workflow (`src/service/remake.js` builds it per take).
  966. - **Node packs.** **Settings → Setup → Install missing node packs** adds every pack IV Studio uses to your
  967. ComfyUI's `custom_nodes` in one go: its own small pack (`resources/comfy-nodes/ComfyUI-IV-Studio`) is
  968. copied, the others are downloaded at the versions below (the list lives in `resources/models.json`), and
  969. their requirements are installed with ComfyUI's own Python (never the torch family, which ComfyUI already
  970. has). A folder that's already there is left alone. Restart ComfyUI afterwards. Agents can do the same
  971. with `install_node_packs`. Replace and Cut out also use SAM 3, which recent ComfyUI has built in.
  972. - **Updates.** **Settings → Setup → Updates** checks ComfyUI against its newest stable release and counts
  973. the custom node packs with updates. **Update everything** saves a ComfyUI-Manager snapshot, updates every
  974. pack (Manager included) and ComfyUI through Manager, then restarts ComfyUI and waits for it; nothing runs
  975. while ComfyUI is rendering. **Undo last update** restores the snapshot, and switches back on the plain-folder
  976. packs (IV Studio's own among them) that Manager's restore switches off. It needs ComfyUI-Manager (Setup
  977. offers to install it) and a ComfyUI on this PC; under the ComfyUI Desktop app, which updates ComfyUI itself,
  978. it updates the node packs. Agents: `check_comfy_updates`, `update_comfy`, `undo_comfy_update`.
  979. - **The latent upscaler.** ComfyUI 0.44 and newer have the H3 latent upscaler built in; there, finishes use
  980. ComfyUI's own (same model and size) and the LBH node pack below isn't needed.
  981. | Pack | Used for | Version |
  982. | --- | --- | --- |
  983. | [ComfyUI-MiniMaxH3Mod (RefMods)](https://github.com/Luisacaotica/ComfyUI-MiniMaxH3Mod) | Shots | Comfy Registry 0.2.9 |
  984. | [Fantastic MiniMaxH3 PromptBuilder (media loader)](https://github.com/Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder) | Shots | commit `22e719f` |
  985. | [MiniMax H3 latent upscaler](https://github.com/LBH-123-AI/Comfyui_Minimax_h3_latent_Upscaler) | Shots (ComfyUI before 0.44) | commit `40316cf` |
  986. | [VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) | Shots | commit `4d907be` |
  987. | [DLSS5 Enhancer v15 (Strix-3D)](https://github.com/Strix-3D/ComfyUI-DLSS5-Enhancer-v15) | Shots (Windows only) | Comfy Registry 1.3.1 |
  988. | [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) | Shots | commit `d7297b4` |
  989. | [Impact Pack](https://github.com/ltdrdata/ComfyUI-Impact-Pack) | Shots | Comfy Registry 8.28.3 |
  990. | [Pixaroma (LoRA loader)](https://github.com/pixaroma/ComfyUI-Pixaroma) | Shots | commit `30d4d94` |
  991. | [Easy-Use (seed)](https://github.com/yolain/ComfyUI-Easy-Use) | Shots | commit `b0b47ca` |
  992. | [comfyui_essentials (math)](https://github.com/cubiq/ComfyUI_essentials) | Shots | Comfy Registry 1.1.0 |
  993. | [KJNodes](https://github.com/kijai/ComfyUI-KJNodes) | Shots | commit `37ca7af` |
  994. | [IV Studio nodes (latent cache, shot list)](https://github.com/hollisorg/iv-studio/tree/main/resources/comfy-nodes/ComfyUI-IV-Studio) | Shots | bundled with IV Studio |
  995. | [H3 Multishot](https://github.com/jlucasmcrell/ComfyUI-H3-Multishot) | Sequences | Comfy Registry 2.7.2 |
  996. | [MiniMax H3 Context Loop](https://github.com/ethanfel/ComfyUI-MiniMaxH3-Context-Loop) | Replace and Reframe | Comfy Registry 0.7.3 |
  997. | [H3 One-Click Swap](https://github.com/D3voz/comfyui-h3-oneclick-swap) | Replace | commit `e44a56e` |
  998. | [H3 Face Refine](https://github.com/Carasibana/ComfyUI-H3-FaceRefine) | Replace | commit `d8521d1` |
  999. | [Image Detail Contrast](https://github.com/D3voz/comfyui-image-detail-contrast) | Replace | commit `485a5e2` |
  1000. | [Orion4D FXMax](https://github.com/orion4d/Orion4D_FXMax) | Replace | commit `7048e84` |
  1001. | [Spectrum for MiniMax H3](https://github.com/xmarre/ComfyUI-Spectrum-MiniMax-H3) | Replace | commit `806fe49` |
  1002. | [SeedVR2 Video Upscaler](https://github.com/numz/ComfyUI-SeedVR2_VideoUpscaler) | SeedVR2 finishing | Comfy Registry 2.5.24 |
  1003. | [Frame Interpolation (RIFE)](https://github.com/Fannovel16/ComfyUI-Frame-Interpolation) | Finals on Linux (Linux only) | Comfy Registry 1.0.11 |
  1004. - **Memory.** One model family at a time (below): IV Studio calls `/free` when the next job needs a
  1005. different family.
  1006. ## Models and the GPU
  1007. - **Free** (next to the GPU and RAM readout in the title bar) unloads everything from the GPU and RAM now:
  1008. ComfyUI's models, IV Studio's voice engine and the prompt writer's Ollama model. A render that's running
  1009. keeps its memory until it finishes.
  1010. - **Settings → Models** picks the main H3 model for each workflow from the ones your ComfyUI has, so a
  1011. fine-tune that suits realism or animation can be used where it fits.
  1012. - **One model family at a time.** Before every job, IV Studio stops its own voice engine and, when the job
  1013. before used a different family (H3 video, music or design pictures), asks ComfyUI to unload first. Jobs
  1014. of the same family keep their models loaded.
  1015. ## Cloud
  1016. No strong graphics card, or want your PC back while it renders? The **Cloud** page renders on a GPU in your
  1017. own [RunPod](https://www.runpod.io) or [Modal](https://modal.com) account instead: your account, billed to
  1018. you by them. Or use [Comfy Cloud](https://www.comfy.org/cloud), Comfy's own hosted ComfyUI. Pick one on the
  1019. page, or press **Guided setup** for a few steps: pick a service, connect your account, choose a GPU and when it
  1020. shuts off, set it up, switch it on. Check my PC offers the same wizard when it recommends the cloud.
  1021. ### On Comfy Cloud
  1022. 1. **Comfy account.** Paste a Comfy API key from [platform.comfy.org](https://platform.comfy.org/profile/api-keys)
  1023. (the Comfy.org key you saved for the paid prompt writer works too). Comfy Cloud's API needs a paid Comfy
  1024. Cloud plan; runs are billed to your Comfy account, and nothing runs between renders.
  1025. 2. **What works there.** Comfy Cloud runs ComfyUI's own nodes and a fixed set of node packs that Comfy
  1026. maintains, with its own model library; you can't install node packs there. So IV Studio asks it (free, no
  1027. render) and lists what works: pictures and music use ComfyUI's own nodes, while video shots need IV
  1028. Studio's node packs and run only if Comfy Cloud offers them. Check again any time; Comfy adds models and
  1029. packs.
  1030. ### On RunPod
  1031. 1. **RunPod account.** Paste an API key from RunPod's Settings → API Keys page (read/write). It is checked
  1032. with RunPod, then stored encrypted on your PC, and used only to make your storage volume and to start and
  1033. stop your own pods.
  1034. 2. **GPU and shut-off.** Pick an L40S or RTX 6000 Ada (48 GB), A100 or H100 (80 GB), RTX 5090 (32 GB) or RTX 4090 (24 GB). The
  1035. page shows RunPod's live hourly price and whether each is free right now; billing is by the second.
  1036. 3. **Set up.** IV Studio makes a 100 GB network volume in a RunPod data center that has your GPU and starts a
  1037. pod from RunPod's official PyTorch image with this version's `resources/cloud` folder. The first pod installs
  1038. ComfyUI and the same pinned node packs as Modal onto the volume, downloads the H3 models (each checked
  1039. against its published SHA-256) and receives your character LoRAs, so later pods start in a few minutes. When
  1040. a new IV Studio changes the cloud setup, the next pod installs it again by itself (your models stay).
  1041. RunPod pods don't sleep by themselves, so the pod's gate (`resources/cloud/gate.py`, which also asks for IV
  1042. Studio's token on every request) deletes the pod after your idle time with an empty queue. The volume keeps
  1043. ComfyUI, the models and every render. The next render starts a new pod; if your GPU is taken in that data
  1044. center, IV Studio starts the next H3-ready one that's free. The volume is billed by RunPod while it exists
  1045. (about $7 a month for 100 GB); delete it on RunPod's Storage page when you're done with the cloud.
  1046. ### On Modal
  1047. 1. **Cloud tools.** IV Studio installs a private copy of Modal's client in its own folder (about 100 MB).
  1048. 2. **Modal account.** Sign in on Modal's own page; signing up is free.
  1049. 3. **GPU and shut-off.** Pick an L40S (48 GB, recommended), A100 or H100 (80 GB), and how long it waits
  1050. with nothing to do before it switches off (3, 5, 10 or 20 minutes). The Cloud page shows each GPU's
  1051. hourly price; billing is by the second, only while the GPU is on.
  1052. 4. **Set up.** IV Studio deploys its ComfyUI app to your account and copies the H3 models into a Modal
  1053. volume (about 60 GB) once. After an IV Studio update that changes the cloud setup, press **Set up again**
  1054. once (your models stay).
  1055. ### Either way
  1056. Then switch **This PC / Cloud**. While you're on the cloud, the title bar shows **GPU on/off · time · $**:
  1057. the GPU time and estimated cost since IV Studio opened, at the chosen GPU's list price. Click it for the
  1058. Cloud page, where **Shut down GPU** stops it at once instead of waiting for the idle shut-off. The next
  1059. render wakes it again (about 1 to 3 minutes on Modal, 2 to 5 on RunPod). The Cloud page estimates a 10-second 2 MP shot at roughly 3 to
  1060. 5 minutes of GPU, about $0.13 on an L40S.
  1061. **What runs on RunPod and Modal:** nearly everything. Create's video shots and Sequences, pictures (every
  1062. family, Generate and Edit) and the picture tools, Projects sketches, designing a character's stills and clips,
  1063. Music, Sounds, Cut out, Reframe, Replace (Swap people and Change the scene, on Viggle Remake), Effects on clips
  1064. and photos, Retake in the editor, the SeedVR2 finish and Enhance, and Voices (Lines, **Speak it**, and Whisper
  1065. reading lines back). Finals use a 2× AI upscale (Real-ESRGAN)
  1066. and RIFE frame interpolation (48, 72 or 120 fps), or SeedVR2, in place of DLSS 5, which needs an NVIDIA card on
  1067. Windows. The cloud runs ComfyUI v0.44.1 with an exactly pinned torch, and takes its node packs from the same
  1068. pinned list Setup installs on a PC.
  1069. **Models on first use.** Setup puts only H3's models in your cloud storage. Everything else brings its own
  1070. models the first time you use it there: IV Studio lists them with their size and asks before downloading
  1071. (on Modal on a CPU, a few cents; on RunPod in the GPU you're already using). Each file is checked against its
  1072. published SHA-256 and kept for next time. Picture families use one pinned model each in the cloud (Flux.2
  1073. Klein 9B, Flux 3 Klein, Krea 2 Turbo, Moss, Qwen Image 2.1, Z-Image Turbo and SDXL base); on a PC your own
  1074. files are used. If a download won't fit on your RunPod volume, IV Studio says how much bigger it must be and
  1075. what that adds a month, and grows it only if you agree (RunPod volumes can grow, never shrink; about $0.07 per
  1076. GB a month). Modal's storage is free up to 1 TiB.
  1077. **Gated models.** Flux.2 Klein 9B, Flux 3 Klein and the LTX effects (Dub, Clean plate, Day to night, Add
  1078. water, SDR to HDR, Transformations and Transitions) are behind a licence on Hugging Face. To use them in the
  1079. cloud, accept each licence on its Hugging Face page, then paste a Read token on the Cloud page (stored
  1080. encrypted; used only for those downloads). The same token serves downloads on your PC (Settings → Setup).
  1081. **Your LoRAs and RefMods.** A cloud render that uses a LoRA or RefMod from this PC uploads it first, once,
  1082. checked by SHA-256 (from your local ComfyUI's folders, or IV Studio's own `models` folder on a PC without
  1083. ComfyUI).
  1084. **On Comfy Cloud** the check above decides it: Images and Music run there when Comfy Cloud has their models.
  1085. **Voices in the cloud.** IV Studio's own voice engine (VoxCPM2 and Whisper, the same as on a PC) runs beside
  1086. ComfyUI on your cloud GPU. Press **Set up voices in the cloud** once on Audio > Voices: about 12 GB goes into your
  1087. cloud storage (on Modal its Python is part of the cloud image and the models download on a CPU; on RunPod a GPU
  1088. installs both onto your volume in 10 to 20 minutes, about $0.30). Each line then runs on the cloud GPU, billed by
  1089. the second; the engine stops as soon as a render is queued, and after 10 idle minutes.
  1090. **What still needs this PC:** live step pictures while a shot renders (they need a
  1091. connection held open, which would keep the GPU billing), Replace's old engine, the H3 pass of the free
  1092. Seedance finish, and New angle. Training a character runs on your PC, RunPod or Modal, whichever you pick.
  1093. ## Agents (MCP)
  1094. IV Studio includes a local MCP server (stdio) with 214 tools. It uses the same projects, characters, voices
  1095. and songs as the window, so Claude Code or any MCP client can render shots and sequences, make pictures,
  1096. speak lines, make music, cut them together and export. **Settings → Agents** has the command for your
  1097. install, a message to paste into any agent, and a button that adds the IV Studio skill to Claude Code.
  1098. **Start menu.** When a chat opens without a request, the agent offers IV Studio's menu as one
  1099. multiple-choice question: a shot, a picture, a longer scene, a spoken line, music, an edit, a website film,
  1100. a swap, a new character or a tour. Each choice comes with what to do next (`get_menu`). The same choices,
  1101. plus `start`, are MCP prompts, so Claude Code lists them as slash commands (`/mcp__iv-studio__…`).
  1102. For a development checkout:
  1103. ```
  1104. claude mcp add iv-studio -e ELECTRON_RUN_AS_NODE=1 -- "<checkout>\node_modules\electron\dist\electron.exe" "<checkout>\out\main\mcp.js"
  1105. ```
  1106. Agents learn how to use it from `resources/agent-guide.md`: the server's instructions on connect, the
  1107. `get_guide` tool, and the Claude Code skill ([`skills/iv-studio/SKILL.md`](skills/iv-studio/SKILL.md)).
  1108. <details>
  1109. <summary>All tools</summary>
  1110. - **Guide and start menu:** `get_guide`, `get_menu`.
  1111. - **Images:** `list_image_models`, `make_image`, `list_images`, `get_image`, `cancel_image`, `delete_image`, `last_frame`.
  1112. - **Activity:** `list_activity`.
  1113. - **This PC:** `scan_hardware` (what Check my PC sees and recommends), `free_memory`.
  1114. - **Shots:** `check_setup`, `install_node_packs`, `check_comfy_updates`, `update_comfy`, `undo_comfy_update`, `list_characters`, `list_projects`, `plan_render`, `check_prompt`,
  1115. `list_samplers`, `generate_previews`, `finish_candidate`, `enhance_final`, `rank_takes`, `use_clean_stretch`, `review_take`, `make_previs`, `soften_mouth`.
  1116. - **Cast and places:** `list_cast`, `save_place`.
  1117. - **Projects (short films):** `list_films`, `create_film`, `get_film`, `update_film`, `set_film_script`,
  1118. `write_film_script`, `break_down_film`, `sketch_film_shots`, `edit_film_shot`, `write_film_shot_prompt`,
  1119. `speak_film_line`, `use_film_recording`, `draw_film_face`, `use_film_face`, `draw_place_angles`,
  1120. `make_animatic`, `render_film_shot`, `render_film_scene`, `finish_film_shot`, `build_rough_cut`.
  1121. - **Sequences:** `list_sequences`, `get_sequence`, `save_sequence`, `render_take`, `hunt_shot`,
  1122. `finish_shot`, `retake`, `render_out`.
  1123. - **Prompt writing:** `write_prompt`, `write_shots_from_story`.
  1124. - **Jobs:** `get_job`, `cancel_job`, `get_outputs`, `make_dailies` (an overnight batch's reel and notes).
  1125. - **References:** `prepare_media` (crop a picture, trim and crop a video or sound, or fit it to H3's sizes).
  1126. - **Library:** `list_renders`, `rename_project`, `delete_project`, `delete_sequence`.
  1127. - **Recommended LoRAs and turnarounds:** `recommended_loras`, `download_recommended_lora`, `make_turnaround`, `turnaround_status`.
  1128. - **Edit:** `list_edits`, `get_edit`, `create_edit`, `set_edit_settings`, `delete_edit`, `add_media`,
  1129. `edit_timeline` (add, insert, overwrite, move, trim, split, ripple delete, fades, volume, titles, tracks
  1130. and their hide/lock/mute/solo, markers, all checked before anything changes), `grab_frame`, `export_edit`,
  1131. `get_edit_export`, `cancel_edit_export`, `export_edit_for_editors` (Premiere, Resolve, Final Cut).
  1132. - **New footage on the timeline:** `generate_in_edit` (extend, bridge, fill or retake), `list_generations`,
  1133. `pick_generation`, `cancel_generation`, `cut_out`, `reframe`, `make_reel`.
  1134. - **Voices:** `voice_status`, `setup_voices`, `list_voices`, `design_voice`, `create_voice`, `update_voice`,
  1135. `delete_voice`, `speak_line`, `list_lines`, `delete_line`, `release_voice_engine`.
  1136. - **Music:** `music_status`, `make_music`, `list_music`, `get_music`, `cancel_music`, `rename_music`,
  1137. `delete_music`.
  1138. - **LoRAs:** `search_loras`, `get_lora`, `download_lora` (needs `CIVITAI_API_KEY` in the server's
  1139. environment), `list_my_loras`, `identify_lora`.
  1140. - **Characters:** `list_ready_characters`, `install_ready_character`, `save_character`, `delete_character`,
  1141. `list_choices` (LoRAs and RefMods), `make_refmod_character`.
  1142. - **Character training:** `list_character_trainings`, `get_character_training`,
  1143. `create_character_training`, `update_character_training`, `design_faces`, `pick_face`, `design_scenes`,
  1144. `pick_still`, `make_training_clips`, `set_training_item`, `add_training_files`, `rank_likeness`,
  1145. `estimate_training` and `start_training` (on this PC, RunPod or Modal, with the recipe options and `more` to
  1146. carry a run on; a paid run needs the person's OK and `confirm_cost`), `stop_training`, `test_checkpoints`,
  1147. `score_checkpoints`, `adopt_checkpoint`.
  1148. - **Replace:** `replace_check`, `replace_video`, `replace_history`, `remake_paint`, `remake_use_picture`, `remake_render`.
  1149. - **Shinobi:** `shinobi_status`, `shinobi_setup`, `shinobi_tools`, `shinobi`, `shinobi_project`.
  1150. - **Sizzle:** `sizzle_capture`, `view_sizzle_capture`, `list_sizzles`, `get_sizzle`, `save_sizzle_plan`,
  1151. `approve_sizzle_plan`, `make_sizzle_assets`, `sizzle_first_cut`, `sizzle_to_shinobi`, `delete_sizzle`.
  1152. - **Models:** `list_h3_models`, `set_workflow_model`.
  1153. An edit open in the window reloads when an agent changes it; a strip says what changed, with a one-click
  1154. Undo, and tracks the person locks refuse the agent.
  1155. The MCP server always renders on the local ComfyUI.
  1156. </details>
  1157. ## Use it well
  1158. - **Terms.** Using MiniMax H3 through IV Studio means agreeing to the [IV Studio terms of use](TERMS.md): real people
  1159. only with their consent, nothing involving minors, say it's AI when you post it, and the rest of MiniMax's use
  1160. restrictions. How IV Studio guards against misuse, and what it doesn't do yet, is in
  1161. [docs/SAFEGUARDS.md](docs/SAFEGUARDS.md).
  1162. - **Report misuse.** Seen something made with IV Studio that breaks the terms, or uses you or someone else without
  1163. consent? Email [abuse@infinitevariance.ai](mailto:abuse@infinitevariance.ai) (or **Settings → About → Report
  1164. misuse**). Every report is read and acted on.
  1165. - **Model licences.** IV Studio doesn't bundle any model weights; each one downloads from its own host under
  1166. its own licence, linked from Setup. Read them before commercial work. In particular:
  1167. - **MiniMax H3** is under the MiniMax H3 Community Licence, which covers use worldwide *except* the EU,
  1168. the UK, South Korea and the USA. Use in those places needs a licence from MiniMax.
  1169. - **MiniMax Music 3** is under the MiniMax-Music3 Community Licence: commercial use is allowed if the
  1170. product shows "MiniMax-Music3", with MiniMax's written permission above $20M a year.
  1171. - **ACE-Step 1.5**, **VoxCPM2** and **Qwen3-VL** are Apache-2.0; **Whisper** is MIT.
  1172. - **InsightFace's** face models (only for likeness scoring) are for non-commercial research use.
  1173. - **People.** Characters and voices must be invented, your own, or of someone who agreed. Don't make a real
  1174. person say or do things without their consent, and don't clone a voice from a recording you found.
  1175. - **Music.** Write your own lyrics and describe a style rather than imitating a named artist.
  1176. ---
  1177. ## Develop
  1178. ```
  1179. npm install
  1180. node node_modules/electron/install.js # npm 11 skips Electron's install script
  1181. npm run build
  1182. "Start IV Studio (dev).bat"
  1183. npm run dist # unsigned NSIS installer in dist/
  1184. ```
  1185. Tests are in `test/`:
  1186. - `graph-parity.mjs`: the headless graph matches the ComfyUI GUI export for 32 switch states.
  1187. - `service-e2e.mjs`: renders previews and a finish on a live ComfyUI.
  1188. - `mcp-smoke.mjs`, `mcp-tools.mjs`, `mcp-live.mjs`: the MCP server over stdio, every editor, library,
  1189. model and character tool, and an agent's edit reloading in an open dev window.
  1190. - `mcp-voices.mjs`: every voice tool against a set-up voice engine (pass its folder).
  1191. - `mcp-music.mjs`: every music tool against the local ComfyUI (`--minimax` adds a MiniMax song).
  1192. - `mcp-loras.mjs`: the LoRA tools against live Civitai and the local ComfyUI (downloads nothing).
  1193. - `civitai-download.mjs`: Civitai downloads against a mock Civitai (checksum, missing key, real-person refusal).
  1194. - `edit-export.mjs`: exports a five-clip edit with the bundled ffmpeg.
  1195. - `replace.mjs`, `shinobi.mjs`, `training-local.mjs`, `sequence-graphs.mjs`: Replace, Shinobi, character
  1196. design and sequences on real hardware (the last one queues GPU renders).
  1197. - `media-prepare.mjs`, `models-download.mjs`, `prompt-writer.mjs`: media trims, checked downloads and the
  1198. local prompt writer.
  1199. - `tours.mjs`: every How it works tour exists, reads well, and points only at parts the window still has.
  1200. - `terms.mjs`: which graphs count as MiniMax H3, the terms gate before H3 renders and training, and that
  1201. [TERMS.md](TERMS.md) carries MiniMax's use restrictions.
  1202. - `hardware.mjs`, `training-recipe.mjs`, `training-runpod.mjs`, `sampler-choice.mjs`, `refmods.mjs`,
  1203. `news.mjs`: Check my PC's advice, the training recipe and its spending cap, RunPod training against a mock,
  1204. the sampler choice, RefMod characters and What's new.
  1205. ## Licences
  1206. IV Studio is MIT-licensed (see [LICENSE](LICENSE)); the Infinite Variance eye artwork is Infinite Variance's
  1207. own and isn't covered by the MIT licence. Third-party notices are in
  1208. [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). The bundled FFmpeg build is GPL.
  1209. IV Studio is Powered by MiniMax H3. MiniMax H3 is licensed under the MiniMax H3 Community License Agreement,
  1210. Copyright © 2026 MiniMax. All Rights Reserved. A copy of that licence ships in
  1211. [resources/licenses/MiniMax-H3-LICENSE.txt](resources/licenses/MiniMax-H3-LICENSE.txt), and using H3 through
  1212. IV Studio is subject to the [terms of use](TERMS.md).
  1213. Screenshots show Tess Marlow and Theo Lindqvist, invented IV Studio characters, and other shots, pictures and
  1214. songs made with IV Studio. The LoRA previews in the LoRAs screenshots are by their makers on Civitai.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.