bitGen Studio

安装 bitGen Studio

一个文件就能装好一切：工作室、ComfyUI、节点包和适合你显卡的模型。这里是每一步——装了什么、装在哪里，以及如何手动完成。

获取安装程序

开始之前

系统Windows 10 或 11、Linux、macOS
显卡安装了最新驱动的 NVIDIA 显卡（RTX 50 系列显卡需要支持 CUDA 13 的驱动）
仅编辑器任何显卡——编辑器、时间线和草图建模都不需要 AI
小型 AI6-12 GB 显卡
中型 AI12-20 GB 显卡；在 16 GB 显卡上，MiniMax H3 以 16 GB 模式运行
全部20 GB 或以上的显卡
磁盘完整模型需要 100 GB 可用空间（ComfyUI 有数 GB，MiniMax H3 模型约 70 GB）
  • 先更新显卡驱动。
  • 选一个大而快的硬盘——有 SSD 就用 SSD。除非你另选位置，应用、ComfyUI 和模型都放在那里的同一个文件夹中。
  • 预留一两个小时。几乎都是在下载：带 PyTorch 的 ComfyUI 有几 GB，MiniMax H3 模型约 70 GB。
  • 可选：免费的 Hugging Face 账户和读取令牌，用于受限模型——FLUX.2 Klein 9B 和 Lightricks 的 LTX 文件。请先在 Hugging Face 上接受它们的许可。

运行安装程序

从下载页面获取适合你系统的文件，放进一个空文件夹。它会把 bitGen Studio 安装到旁边的 Bitgen-Studio 文件夹。

Windows 10 / 11

  1. 把 install_all.bat 放进一个空文件夹，例如 D:\AI。
  2. 双击它。如果 Windows 询问是否运行来自互联网的文件，选择“运行”。
  3. 缺少 Git、Node.js 和 Python 时会安装它们——通过 winget，或从它们的官网。Windows 可能会询问是否允许 Git 或 Node.js 进行更改：选“是”。不需要管理员账户。
  4. 它从 GitHub 获取 bitGen Studio 并运行 start.bat，后者添加 Node 和 Python 包以及应用窗口（约 150 MB，只需一次），然后打开安装窗口。

以后：双击 Bitgen-Studio 文件夹中的 start.bat 打开工作室。

Linux

  1. 把 install_all.sh 放进一个空文件夹。
  2. 在该文件夹中打开终端并运行 sh install_all.sh。
  3. Git 来自你的包管理器（apt、dnf、yum、pacman、zypper 或 apk），所以会询问一次密码。
  4. 首次启动会把 Node.js、Python 3.12、ffmpeg、各种包和应用窗口装进应用文件夹——不装到系统里，不需要密码——把 bitGen Studio 加到应用菜单和桌面，并打开安装窗口。

以后：从应用菜单打开 bitGen Studio，或再次运行该文件。

macOS

  1. 把 install_all.command 放进一个空文件夹。
  2. 双击它。如果 macOS 阻止它，右键点击并选择“打开”——或在终端中运行 sh install_all.command。
  3. Git 在你有 Homebrew 时从 Homebrew 安装，否则来自 Apple 的 Command Line Tools：会弹出窗口请求安装，安装程序会等待。
  4. 首次启动会把 Node.js、Python 3.12、ffmpeg、各种包和应用窗口装进应用文件夹，添加 ~/Applications/bitGen Studio.app，并打开安装窗口。

以后：打开 bitGen Studio.app。

安装程序会给每行上色：已完成的步骤为绿色，正在进行的为浅绿色，警告为橙色，错误为红色。某个步骤又长又安静时，它会提示仍在进行——并没有卡住。

安装窗口

工作室第一次启动时会打开它，并依次经过这些页面。

  1. 你的硬件它检查你的显卡、显存（VRAM）和内存，并告诉你工作室能用它们做什么。
  2. 你的套餐选择要安装工作室的多少部分。适合你显卡的已经选好，其余的以后可在 设置 ▸ 模型 中添加。
    编辑器不含 AI。视频和图像编辑器、CAD 与 3D 草图、声音和交付。无需 ComfyUI，无需模型——任何电脑几分钟就绪。
    编辑器 + 小型 AI6–12 GB 显卡。ComfyUI 和小型模型：Anima 和 SDXL 图像、去除背景、语音转文字、配音、小型助手。
    编辑器 + 中型 AI12–20 GB 显卡。增加 Krea 2 和 FLUX 3 Klein 图像、Kontext 和 Qwen 2.1 编辑、较小尺寸的 MiniMax H3 视频、歌曲和放大。
    全部20 GB 以上显卡。完整尺寸的整个工作室：MiniMax H3 场景、Qwen Image Edit、大型图像模型、LTX 2.5 和角色替换。
  3. ComfyUI在你选择的文件夹中安装新的 ComfyUI，或使用你已有的。新的会有自己的 Python 和适合你显卡的 PyTorch——RTX 50 用 CUDA 13.0 或 12.8，RTX 20–40 用 12.8 或 12.6，Mac 用 Metal。工作室用到的所有自定义节点包会一起安装，然后 ComfyUI 检查每个能否加载。
  4. 同时安装OmniVoice（声音克隆和文字转语音，约 3 GB）、助手引擎 llama.cpp（剧本、提示词聊天和 ✨ 增强）以及 faster-whisper（转录和歌词计时）。Viggle (native) 是可选的，默认不勾选：约 5 GB，加上你的 ComfyUI 还没有的模型部分。
  5. 安装每个步骤及其日志。同时会做出适合你显卡的设置：按显存设定的渲染尺寸和长度、语言模型在哪里运行、语音在显卡还是处理器上处理。
  6. 模型你的套餐需要的模型文件，已勾选并标出大小——见下方模型。
  7. 就绪如果没有需要报告的，几秒后工作室会自动打开，ComfyUI 也随之启动——你马上就能开始创作。需要你处理的事项会列出来，也写在应用文件夹的 setup.log 中。

模型

模型来自 Hugging Face。安装程序会列出你的套餐用到的每个文件及其大小，适合你显卡的已勾选。

  • 没有 Hugging Face 令牌时只能下载公开模型。有令牌的话，你的账户已接受许可的受限模型也能下载。
  • 用 Hugging Face CLI（hf download——大文件更快）或内置下载器下载。连接中断时两者都能从中断处继续：再运行一次安装即可。
  • 选 “Skip - I'll add models myself” 会跳过模型。工作室里的 设置 ▸ 模型 ▸ ⤓ 模型目录 随时都是同一份列表。
  • 每次渲染前，工作室都会检查所需文件是否存在，并提出下载缺少的文件。

MiniMax H3 视频模型放在 ComfyUI 的 models 文件夹中：

文件文件夹大小用途
minimax_h3_ref2va_pruned_int8_convrot.safetensorsdiffusion_models~21 GB参考图生成视频、续接场景、角色替换
minimax_h3_fl2va_pruned_int8_convrot.safetensorsdiffusion_models~21 GB首尾帧生成视频
qwen3vl_32b_minimax_h3_nvfp4_awq.safetensorstext_encoders~17 GB文本编码器
minimax_h3_video_vae_fp16.safetensorsvae1.4 GB视频 VAE
minimax_h3_audio_vae_fp32.safetensorsvae0.4 GB音频 VAE

已经有 ComfyUI？

在安装窗口选择 “Use a ComfyUI I already have”，然后浏览到它的文件夹——便携版、git 安装或带有自己 Python 环境的文件夹。安装程序会显示它已经有工作室的哪些节点包，并补上其余的。你的模型保持原位：bitGen 会读取 ComfyUI 的模型文件夹和 extra_model_paths.yaml。

以后可在 设置 ▸ ComfyUI 中设置：文件夹（含 main.py 的那个）和地址，默认 http://127.0.0.1:8188。更多见ComfyUI 用户页面。

没有大显卡？

编辑器套餐在任何电脑上都能运行。AI 部分可以通过 设置 ▸ 远程 GPU 用另一台机器的显卡渲染：

  • 另一台电脑上的 ComfyUI——它的地址，例如 http://192.168.1.20:8188，ComfyUI 需用 --listen 启动。
  • RunPod——你的 API 密钥会列出你的 Pod 及其显卡和价格；启动一个并使用它的 ComfyUI。
  • 通往你能登录的机器的 SSH 隧道。

✓ 测试 会询问那个 ComfyUI 的显卡和版本，使用 会让工作室连到它。任务用到的模型必须在那台机器上。

手动安装

想自己动手？先安装这些：

NVIDIA 驱动最新版——nvidia.com/drivers
Node.js 18+运行工作室——nodejs.org 上的 LTS 版
Python 3.10+运行工作进程——python.org；在 Windows 上勾选 Add python.exe to PATH
Git用来安装 ComfyUI 及其节点包——git-scm.com
ffmpeg剪切、拼接和预览——在 Windows 上运行 winget install Gyan.FFmpeg，然后打开新的终端

然后获取工作室并启动：

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 第一次会安装缺少的东西，之后每次都会打开工作室。在 Linux 和 macOS 上，文件夹内的 install_all.sh 会直接使用该文件夹。没有 Git？下载 zip 并解压——不过 ComfyUI 仍需要 Git。

不用安装窗口

node scripts/setup-cli.js --comfy new --models recommended --hf-token hf_...
node scripts/setup-cli.js --detect          # 硬件检查
node scripts/setup-cli.js --list-models     # 模型 ID
node scripts/setup-cli.js --only-models --models ltx23_omninft --downloader hf

开关

BITGEN_NO_START=1安装，但不打开工作室
BITGEN_REPO从另一个地址克隆
NO_COLOR=1纯文本，不带颜色
H3_NO_SHELL=1不用应用窗口——在浏览器中打开 http://127.0.0.1:8311
H3_SETUP=1再次打开安装窗口（或删除应用文件夹中的 .setup-done）

更新

设置 ▸ 常规 ▸ ⟳ 更新：🔍 检查更新 列出新内容，⤓ 立即更新 换上最新版本，⟳ 立即重启 完成更新。你的项目、设置、风格、模型和 ComfyUI 都不会被改动。工作室启动后不久也会悄悄检查，有新版本时提醒你一次。

在终端中：在应用文件夹里运行 git pull，然后重新启动。每个版本的新内容见更新日志。

卸载

  1. 关闭 bitGen Studio如果 ComfyUI 还在运行，也一并停止。
  2. 保留你做的东西把 projects 文件夹从应用文件夹中复制出来（想保留风格和设置的话，还有 styles、graphs 和 custom.settings）。
  3. 删除应用文件夹Bitgen-Studio 文件夹里有工作室及它安装的一切——如果你没有放到别处，ComfyUI 和模型也在里面。
  4. 删除启动器Linux：~/.local/share/applications/bitgen-studio.desktop 及其在桌面上的副本。macOS：~/Applications/bitGen Studio.app。

Git、Node.js 和 Python 会保留——其他程序可能在用它们。如果都不需要，用你系统的常规方法删除。

出现问题时

某个安装步骤失败查看应用文件夹中的 setup.log，然后再次运行安装程序——已完成的会保留，下载会从中断处继续。
ComfyUI 未运行且无法启动设置 ▸ ComfyUI：检查文件夹和地址。控制台面板会显示 ComfyUI 自己的输出。
未找到模型在工作室弹出的框中点击 ⬇ 下载。受限模型需要你的 Hugging Face 令牌（设置 ▸ 模型），并已接受其许可。
任务失败并提到某个节点安装那个节点包（ComfyUI-Manager ▸ Install Missing Custom Nodes），然后重启 ComfyUI。消息里会写出包名。
内存不足降低尺寸或长度，或把 设置 ▸ ComfyUI ▸ 释放时机 设为“每次生成前”。工作室会记住你的显卡完成过的最长片段，更长的会自动拆分。
第一次渲染很慢第一次时 ComfyUI 要从磁盘加载模型；只要模型不变，之后的渲染都会重复使用它。
“You need pytorch with cu130”RTX 50 系列显卡：先更新显卡驱动，再重新安装 ComfyUI 的 PyTorch。
应用窗口一直不出现用 H3_NO_SHELL=1 启动，然后在浏览器中打开 http://127.0.0.1:8311。
窗口全黑，或布局跑出屏幕关闭工作室，在应用文件夹中运行 misc\reset-layout.bat：它会恢复默认布局，并保留你的项目、设置和模型。

还是不行？附上控制台面板的输出和队列面板中失败任务的日志报告错误，或在讨论区提问。