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：它會恢復預設版面，並保留你的專案、設定和模型。

還是不行？附上主控台面板的輸出和佇列面板中失敗工作的記錄報告錯誤，或在討論區提問。