Install bitGen Studio
One file sets up everything: the studio, ComfyUI, the node packs and the models for your graphics card. Here is each step - what it installs, where it goes, and how to do it by hand.
- Before you start
- Run the installer
- The setup window
- The models
- Already have ComfyUI?
- No big graphics card?
- Install by hand
- Updating
- Uninstalling
- When something goes wrong
Before you start
| System | Windows 10 or 11, Linux, macOS |
|---|---|
| Graphics card | NVIDIA with a current driver (RTX 50-series cards need a CUDA 13 driver) |
| Editor only | Any card - the editors, the timeline and Sketcher need no AI |
| Small AI | A 6-12 GB card |
| Mid-size AI | A 12-20 GB card; MiniMax H3 runs in 16 GB mode on a 16 GB card |
| Everything | A card with 20 GB or more |
| Disk | 100 GB free for the full set of models (ComfyUI is several GB, the MiniMax H3 models about 70 GB) |
- Update your graphics driver first.
- Pick a big, fast drive - an SSD if you have one. The app, ComfyUI and the models all go in one folder there unless you choose others.
- Plan for an hour or two. Almost all of it is downloading: ComfyUI with PyTorch is several GB, the MiniMax H3 models about 70 GB.
- Optional: a free Hugging Face account and a read token, for the gated models - FLUX.2 Klein 9B and Lightricks' LTX files. Accept their licences on Hugging Face first.
Run the installer
Download the file for your system from the Download page and put it in an empty folder. It installs bitGen Studio into a Bitgen-Studio folder beside it.
Windows 10 / 11
- Put
install_all.batin an empty folder, for exampleD:\AI. - Double-click it. If Windows asks whether to run a file from the internet, choose Run.
- It installs Git, Node.js and Python when they are missing - through winget, or from their own websites. Windows may ask you to allow Git or Node.js to make changes: say Yes. No administrator account is needed.
- It fetches bitGen Studio from GitHub and runs
start.bat, which adds the Node and Python packages and the app window (about 150 MB, once), then opens the setup window.
Later: double-click start.bat in the Bitgen-Studio folder to open the studio.
Linux
- Put
install_all.shin an empty folder. - Open a terminal in that folder and run
sh install_all.sh. - Git comes from your package manager (apt, dnf, yum, pacman, zypper or apk), so it asks for your password once.
- The first start puts Node.js, Python 3.12, ffmpeg, the packages and the app window inside the app folder - nothing system-wide, no password - adds bitGen Studio to the app menu and the desktop, and opens the setup window.
Later: open bitGen Studio from the app menu, or run the file again.
macOS
- Put
install_all.commandin an empty folder. - Double-click it. If macOS blocks it, right-click it and choose Open - or run
sh install_all.commandin Terminal. - Git comes from Homebrew when you have it, otherwise from Apple's Command Line Tools: a window asks to install them and the installer waits.
- The first start puts Node.js, Python 3.12, ffmpeg, the packages and the app window inside the app folder, adds
~/Applications/bitGen Studio.appand opens the setup window.
Later: open bitGen Studio.app.
The installer colours its lines: finished steps green, the step running now a lighter green, warnings orange, errors red. When a step is long and quiet, it says it is still working - it has not stalled.
The setup window
It opens the first time the studio starts and walks through these pages.
- Your hardwareIt checks your graphics card, its memory (VRAM) and your RAM, and says what the studio can do with them.
- Your packagePick how much of the studio to install. The one that suits your card is already picked, and you can add the rest later in Settings ▸ Models.
Editor No AI. The video and image editor, CAD and 3D sketching, sound and delivery. No ComfyUI, no models - ready in minutes on any computer. Editor + small AI A 6-12 GB card. ComfyUI and the small models: Anima and SDXL pictures, background removal, speech to text, voices, a small assistant. Editor + mid-size AI A 12-20 GB card. Adds Krea 2 and FLUX 3 Klein pictures, Kontext and Qwen 2.1 editing, MiniMax H3 video at a smaller size, songs and upscaling. Everything A 20 GB+ card. The whole studio at full size: MiniMax H3 scenes, Qwen Image Edit, the big image models, LTX 2.5 and character swap. - ComfyUIInstall a new ComfyUI in a folder you choose, or use one you already have. A new one gets its own Python and the right PyTorch for your card - CUDA 13.0 or 12.8 for RTX 50, 12.8 or 12.6 for RTX 20-40, Metal on a Mac. Every custom node pack the studio uses is installed with it, then ComfyUI checks that each one loads.
- Also set upOmniVoice (voice cloning and text to speech, about 3 GB), the assistant's engine llama.cpp (screenplays, the prompt chat and ✨ Enhance) and faster-whisper (transcripts and lyric timing). Viggle (native) is optional and unticked: about 5 GB plus the model parts your ComfyUI does not have yet.
- InstallingEach step with its log. Settings that suit your card are made too: render size and length for your VRAM, where the language model runs, speech on the graphics card or the processor.
- ModelsThe model files your package needs, ticked, with their sizes - see the models below.
- ReadyWith nothing to report, the studio opens by itself a few seconds later and ComfyUI starts with it - you can make something right away. Anything that needs you is listed instead, and in
setup.login the app folder.
The models
Models come from Hugging Face. The setup lists every file your package uses, with its size, and the ones for your card are ticked.
- Without a Hugging Face token only the open models download. With one, so do the gated models whose licence your account has accepted.
- Download with the Hugging Face CLI (
hf download- faster on big files) or the built-in downloader. Either one picks up where it stopped if the connection drops: run the setup again. - Skip - I'll add models myself leaves them out. Settings ▸ Models ▸ ⤓ Model catalog is the same list inside the studio, any time.
- Before every render the studio checks the files it needs are there and offers to download any that are missing.
The MiniMax H3 video models go into ComfyUI's models folder:
| File | Folder | Size | Used for |
|---|---|---|---|
minimax_h3_ref2va_pruned_int8_convrot.safetensors | diffusion_models | ~21 GB | reference pictures to video, continuing a scene, character swap |
minimax_h3_fl2va_pruned_int8_convrot.safetensors | diffusion_models | ~21 GB | first and last frames to video |
qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors | text_encoders | ~17 GB | the text encoder |
minimax_h3_video_vae_fp16.safetensors | vae | 1.4 GB | the video VAE |
minimax_h3_audio_vae_fp32.safetensors | vae | 0.4 GB | the audio VAE |
Already have ComfyUI?
Pick Use a ComfyUI I already have in the setup window and browse to its folder - a portable build, a git install or a folder with its own Python environment. The setup shows which of the studio's node packs it already has and adds the rest. Your models stay where they are: bitGen reads ComfyUI's model folders and extra_model_paths.yaml.
Set it later in Settings ▸ ComfyUI: the folder (the one with main.py) and the address, http://127.0.0.1:8188 by default. More on the page for ComfyUI users.
No big graphics card?
The Editor package runs on any computer. For the AI parts, Settings ▸ Remote GPU renders on another machine's card:
- Another computer's ComfyUI - its address, for example
http://192.168.1.20:8188, with ComfyUI started with--listen. - RunPod - your API key lists your pods with their card and price; start one and use its ComfyUI.
- An SSH tunnel to a machine you can sign in to.
✓ Test asks that ComfyUI for its card and version, and Use it points the studio at it. The models a job uses must be on that machine.
Install by hand
Prefer to set things up yourself? Install these first:
| NVIDIA driver | a current one - nvidia.com/drivers |
|---|---|
| Node.js 18+ | runs the studio - the LTS from nodejs.org |
| Python 3.10+ | runs the workers - python.org; on Windows tick Add python.exe to PATH |
| Git | installs ComfyUI and its node packs - git-scm.com |
| ffmpeg | cutting, joining and previews - on Windows winget install Gyan.FFmpeg, then open a new terminal |
Then get the studio and start it:
git clone https://github.com/Tim-byte-dev/Bitgen-Studio.git Bitgen-Studio
cd Bitgen-Studio
start.bat # Windows
sh install_all.sh # Linux / macOS
start.bat installs what is missing the first time and opens the studio every time after. On Linux and macOS, install_all.sh inside the folder uses that folder. No Git? Download the zip and unzip it - ComfyUI still needs Git.
Without the setup window
node scripts/setup-cli.js --comfy new --models recommended --hf-token hf_...
node scripts/setup-cli.js --detect # the hardware check
node scripts/setup-cli.js --list-models # the model ids
node scripts/setup-cli.js --only-models --models ltx23_omninft --downloader hf
Switches
BITGEN_NO_START=1 | install, but do not open the studio |
|---|---|
BITGEN_REPO | clone from another address |
NO_COLOR=1 | plain text, no colours |
H3_NO_SHELL=1 | no app window - use your browser at http://127.0.0.1:8311 |
H3_SETUP=1 | the setup window again (or delete .setup-done in the app folder) |
Updating
Settings ▸ General ▸ ⟳ Updates: 🔍 Check for updates lists what is new, ⤓ Update now puts the newest version in place and ⟳ Restart now finishes it. Your projects, settings, styles, models and ComfyUI are not touched. The studio also checks quietly a little after it starts and tells you once when there is a new version.
From a terminal: git pull in the app folder, then start it again. What is new in each version is in the changelog.
Uninstalling
- Close bitGen StudioStop ComfyUI too if it is still running.
- Keep what you madeCopy the
projectsfolder out of the app folder (andstyles,graphsandcustom.settingsif you want your styles and settings). - Delete the app folderThe
Bitgen-Studiofolder holds the studio and everything it installed - and ComfyUI and the models, unless you put them somewhere else. - Remove the launcherLinux:
~/.local/share/applications/bitgen-studio.desktopand its copy on the desktop. macOS:~/Applications/bitGen Studio.app.
Git, Node.js and Python stay installed - other programs may use them. Remove them the usual way for your system if nothing needs them.
When something goes wrong
| A setup step failed | Read setup.log in the app folder, then run the installer again - what is done is kept and downloads pick up where they stopped. |
|---|---|
| ComfyUI is not running and could not be started | Settings ▸ ComfyUI: check the folder and the address. The Console docker shows ComfyUI's own output. |
| Models not found | Click ⬇ Download in the box the studio shows. A gated model needs your Hugging Face token (Settings ▸ Models) and its licence accepted. |
| A job fails naming a node | Install that node pack (ComfyUI-Manager ▸ Install Missing Custom Nodes) and restart ComfyUI. The message names the pack. |
| Out of memory | Lower the size or the length, or set Settings ▸ ComfyUI ▸ Free it to "before every generation". The studio remembers the longest clip your card finished and splits longer ones. |
| The first render is slow | ComfyUI loads the model from disk the first time; the renders after it reuse it while the model stays the same. |
| "You need pytorch with cu130" | An RTX 50-series card: update the graphics driver, then reinstall ComfyUI's PyTorch. |
| The app window never appears | Start with H3_NO_SHELL=1 and use your browser at http://127.0.0.1:8311. |
| A black window, or the layout off the screen | Close the studio and run misc\reset-layout.bat in the app folder: it puts back the default layout and keeps your projects, settings and models. |
Still stuck? Report a bug with the Console docker's output and the failed job's log from the Queue docker, or ask in the Discussions.