bitGen Studio のインストール

1 つのファイルですべてを準備します：スタジオ、ComfyUI、ノードパック、グラフィックカードに合ったモデル。ここでは各手順 - 何が入り、どこに置かれ、手動ではどうするか - を説明します。

始める前に
インストーラーを実行する
セットアップ画面
モデル
ComfyUI をお持ちですか？
大きなグラフィックカードがない？
手動でインストール
アップデート
アンインストール
うまくいかないとき

始める前に

システム	Windows 10 または 11、Linux、macOS
グラフィックカード	最新ドライバーの NVIDIA（RTX 50 シリーズには CUDA 13 対応のドライバーが必要です）
エディターのみ	どのカードでも可 - エディター、タイムライン、Sketcher は AI を使いません
小規模 AI	6〜12 GB のカード
中規模 AI	12〜20 GB のカード。16 GB のカードでは MiniMax H3 が 16 GB モードで動作します
すべて	20 GB 以上のカード
ディスク	モデル一式のために 100 GB の空き容量（ComfyUI が数 GB、MiniMax H3 のモデルが約 70 GB）

まずグラフィックドライバーを更新します。
大きくて速いドライブを選びます - あれば SSD。ほかを選ばない限り、アプリ、ComfyUI、モデルはすべてそこにある 1 つのフォルダーに入ります。
1～2 時間を見込んでください。ほとんどがダウンロードです：PyTorch 込みの ComfyUI は数 GB、MiniMax H3 のモデルは約 70 GB。
任意：ゲート付きのモデル（FLUX.2 Klein 9B と Lightricks の LTX ファイル）用に、無料の Hugging Face アカウントと読み取りトークン。先に Hugging Face でそれぞれのライセンスに同意してください。

インストーラーを実行する

ダウンロードページからお使いのシステム用のファイルを入手し、空のフォルダーに置きます。bitGen Studio はその隣の Bitgen-Studio フォルダーにインストールされます。

Windows 10 / 11

install_all.bat を空のフォルダー（例：D:\AI）に置きます。
ダブルクリックします。インターネットから入手したファイルを実行するか Windows に聞かれたら、「実行」を選びます。
Git、Node.js、Python がなければインストールします - winget 経由、またはそれぞれの公式サイトから。Git や Node.js による変更を許可するか Windows に聞かれたら「はい」を選びます。管理者アカウントは不要です。
GitHub から bitGen Studio を取得して start.bat を実行します。これが Node と Python のパッケージ、アプリのウィンドウ（約 150 MB、初回のみ）を入れ、セットアップ画面を開きます。

次回から：Bitgen-Studio フォルダーの start.bat をダブルクリックするとスタジオが開きます。

Linux

install_all.sh を空のフォルダーに置きます。
そのフォルダーでターミナルを開き、sh install_all.sh を実行します。
Git はパッケージマネージャー（apt、dnf、yum、pacman、zypper、apk）から入るので、パスワードを一度だけ聞かれます。
初回の起動で Node.js、Python 3.12、ffmpeg、パッケージ、アプリのウィンドウをアプリのフォルダー内に入れ（システム全体には何も入れず、パスワードも不要）、bitGen Studio をアプリメニューとデスクトップに追加して、セットアップ画面を開きます。

次回から：アプリメニューから bitGen Studio を開くか、ファイルをもう一度実行します。

macOS

install_all.command を空のフォルダーに置きます。
ダブルクリックします。macOS にブロックされたら、右クリックして「開く」を選ぶか、ターミナルで sh install_all.command を実行します。
Git は Homebrew があればそこから、なければ Apple の Command Line Tools から入ります。インストールを求めるウィンドウが開き、インストーラーはそれを待ちます。
初回の起動で Node.js、Python 3.12、ffmpeg、パッケージ、アプリのウィンドウをアプリのフォルダー内に入れ、~/Applications/bitGen Studio.app を追加して、セットアップ画面を開きます。

次回から：bitGen Studio.app を開きます。

インストーラーは行に色を付けます：完了した手順は緑、実行中の手順は明るい緑、警告はオレンジ、エラーは赤。長く静かな手順のあいだは、まだ作業中で止まっていないと表示します。

セットアップ画面

スタジオを初めて起動したときに開き、次のページを順に進みます。

お使いのハードウェアグラフィックカード、そのメモリー（VRAM）、RAM を調べ、それでスタジオが何をできるかを示します。

パッケージスタジオをどこまでインストールするか選びます。カードに合うものが既に選ばれていて、残りはあとで設定 ▸ モデルから追加できます。

エディター	AI なし。動画と画像のエディター、CAD と 3D スケッチ、サウンドと書き出し。ComfyUI もモデルもなし - どのコンピューターでも数分で使えます。
エディター + 小規模 AI	6～12 GB のカード。ComfyUI と小さなモデル：Anima と SDXL の画像、背景の除去、音声のテキスト化、音声、小さなアシスタント。
エディター + 中規模 AI	12～20 GB のカード。Krea 2 と FLUX 3 Klein の画像、Kontext と Qwen 2.1 の編集、小さめサイズの MiniMax H3 動画、歌、アップスケールが加わります。
すべて	20 GB 以上のカード。スタジオのすべてをフルサイズで：MiniMax H3 のシーン、Qwen Image Edit、大きな画像モデル、LTX 2.5、キャラクター差し替え。

ComfyUI選んだフォルダーに新しい ComfyUI をインストールするか、手持ちのものを使います。新しいものには専用の Python と、カードに合った PyTorch が入ります - RTX 50 は CUDA 13.0 または 12.8、RTX 20～40 は 12.8 または 12.6、Mac は Metal。スタジオが使うカスタムノードパックもすべて一緒に入り、ComfyUI がそれぞれ読み込めるか確認します。
一緒にセットアップするものOmniVoice（声のクローンと音声合成、約 3 GB）、アシスタントのエンジン llama.cpp（脚本、プロンプトのチャット、✨ 改善）、faster-whisper（文字起こしと歌詞のタイミング）。Viggle (native) は任意でチェックなし：約 5 GB に加え、ComfyUI にまだないモデル部分。
インストール各手順とそのログ。カードに合った設定も行います：VRAM に合ったレンダリングのサイズと長さ、言語モデルを動かす場所、音声処理をグラフィックカードとプロセッサーのどちらで行うか。
モデルパッケージに必要なモデルファイルがチェック済み、サイズ付きで並びます - 下のモデルを参照。
準備完了報告することがなければ、数秒後にスタジオが自動で開き、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.safetensors`	diffusion_models	~21 GB	参照画像から動画、シーンの続き、キャラクター差し替え
`minimax_h3_fl2va_pruned_int8_convrot.safetensors`	diffusion_models	~21 GB	最初と最後のフレームから動画
`qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors`	text_encoders	~17 GB	テキストエンコーダー
`minimax_h3_video_vae_fp16.safetensors`	vae	1.4 GB	動画の VAE
`minimax_h3_audio_vae_fp32.safetensors`	vae	0.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 がカードと料金付きで一覧になります。1 つを起動して、その 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 を実行し、もう一度起動します。各バージョンの変更点は変更履歴にあります。

アンインストール

bitGen Studio を閉じるComfyUI がまだ動いていれば、それも止めます。
作ったものを残すアプリのフォルダーから projects フォルダーをコピーして外に出します（スタイルと設定も残すなら styles、graphs、custom.settings も）。
アプリのフォルダーを削除するBitgen-Studio フォルダーにはスタジオとそれがインストールしたものすべて - 別の場所にしていなければ ComfyUI とモデルも - が入っています。
ランチャーを削除する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` を実行します。既定のレイアウトに戻し、プロジェクト、設定、モデルはそのまま残します。

それでも解決しない？コンソールのドッカーの出力とキューのドッカーにある失敗したジョブのログを添えてバグを報告するか、ディスカッションで質問してください。