ComfyUI セットアップ — ローカル AI 生成
マシン
- Windows 10 Pro、RTX 3090 24GB(Ampere)、28GB RAM(→40GB)、Xeon E5-2696 v4
- ドライブ: C:(OS、35GB 空き)、D: SSD 207GB、E: HDD 9.3TB
- ComfyUI 0.44.0 ポータブル版(CUDA 13、Python 3.13)
D:\AI\ComfyUI
- サーバー:
http://127.0.0.1:8188
フォルダ構成
D:\AI\ComfyUI — アプリ + python_embeded
D:\AI\models\ — 全モデル(extra_model_paths.yaml 経由)
D:\AI\workflows\ — 2d/、3d/、video/ ワークフローJSON
D:\AI\outputs\staging\<project>\ — プロジェクトごとのステージング
D:\AI\cache\ — HF/Torch ダウンロード(HF_HOME、TORCH_HOME)
D:\AI\README.txt、SETUP_DOCUMENTATION.md、HANDOFF.md、PROJECTS.md
モデルフォルダ
| タイプ | フォルダ | ローダー |
|---|
| SDXL チェックポイント | D:\AI\models\checkpoints\ | CheckpointLoaderSimple |
| 拡散モデル(UNET) | D:\AI\models\diffusion_models\ | UNETLoader |
| テキストエンコーダ | D:\AI\models\text_encoders\ | CLIPLoader |
| VAE | D:\AI\models\vae\ | VAELoader |
| ControlNet/パッチ | D:\AI\models\model_patches\ | ModelPatchLoader |
| LoRA | D:\AI\models\loras\ | LoraLoader |
| CLIP vision | D:\AI\models\clip_vision\ | CLIPVisionLoader |
| アップスケール | D:\AI\models\upscale_models\ | UpscaleModelLoader |
| 背景除去 | D:\AI\models\background_removal\ | LoadBackgroundRemovalModel |
| 3D | D:\AI\models\diffusion_models\ + vae\ | ネイティブ3Dノード |
重要なルール
widgets_values と widgets_values_nameded の両方をワークフロー内のモデル名変更時に更新する必要があります。ComfyUI 0.44.0 では widgets_values_named が実際の値として使用されます。
- モデル追加後は ComfyUI を再起動してください(モデルリストは起動時にキャッシュされます)。
- ブラウザキャッシュ: 「モデルが見つかりません」と表示されたら、ページをリロード(F5)し、ワークフローを開き直してください。
- int8/FP8 ビルドが 28GB RAM では必要です。BF16 には 40GB 必要です。
- H3 には
--disable-pinned-memory --fp16-intermediates フラグが必要です。
- モデルタイプを混在させないでください。 Z-Image は UNET/CLIP/VAE(個別)を使用します。SDXL チェックポイントは CheckpointLoaderSimple を使用します。
- extra_model_paths.yaml ではフォワードスラッシュを使用します:
D:/AI/models/。
- HF/Torch キャッシュは D: ドライブに置く必要があります(起動バッチで設定)。
- MarkdownNote ノードにモデル名がテキストで含まれている場合があります。誤った「モデルが見つかりません」警告を避けるため、それらをクリーンにしてください。
新規モデルのインストール
D:\AI\downloads\ に curl でダウンロード。
D:\AI\models\ 配下の正しいフォルダに移動。
- safetensors ヘッダーを確認:
D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<path>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'tensors')"
- ComfyUI を再起動。
http://127.0.0.1:8188/object_info/<LoaderNode> でローダーが認識しているか確認。
- 既存テンプレートからワークフローを作成し、
widgets_values と widgets_values_named の両方を更新。
- API 経由でテスト(
test_zimage.py のパターンを参照)。
- README とドキュメントを更新。
起動コマンド
:: 通常(画像、3D、一般)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager
:: ビデオ(MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates
主要モデルと設定
| モデル | ファイル | 設定 |
|---|
| Z-Image Turbo | int8 UNET + FP8 エンコーダ + ae.safetensors | 8-9 ステップ、CFG 1.0、res_multistep、simple、1024-1344px |
| Nova Anime XL v19 | NovaAnimeILV190.safetensors(SDXL) | 28 ステップ、CFG 5、euler_ancestral、normal、CLIP skip 2 |
| Prefect Pony XL v6 | PrefectPonyXLV6.safetensors(Pony/SDXL) | 28 ステップ、CFG 6、euler_ancestral、normal、CLIP skip 2 |
| Pixal3D/TRELLIS.2 | int8 UNET + VAE + DINOv3 + BiRefNet + MoGe | 1024px、boolean: off=Pixal3D、on=TRELLIS.2 |
| MiniMax H3 | pruned int8 + NVFP4 エンコーダ + ビデオ/オーディオ VAE | 5秒 864x480、4ステップ turbo LoRA; 15秒 1344x768 約23分 |
よくある問題
| 問題 | 解決策 |
|---|
hostbuf_file_reader_read failed | --disable-dynamic-vram を使用、または int8/FP8 ビルドを使用 |
Fault failed: 2(H3) | --disable-pinned-memory --fp16-intermediates + 解像度を下げる |
| 画面が黒くなる(TDR) | 解像度/ステップを減らす; レジストリで TDR 遅延を増やす |
| 「モデルが見つかりません」ダイアログ | 両方の widgets フィールドを修正; ComfyUI を再起動; ページをリロード |
| ドロップダウンにモデルが表示されない | ComfyUI を再起動(モデルリストは起動時にキャッシュされる) |
| H3 I2V が失敗する | FL2VA がインストールされていない; R2V セーフワークフローを使用 |
ドキュメントファイル
D:\AI\README.txt — ユーザー向けクイックリファレンス
D:\AI\SETUP_DOCUMENTATION.md — 全13セクションの完全リファレンス
D:\AI\HANDOFF.md — エージェント向けクイックリファレンス(インストール手順)
D:\AI\PROJECTS.md — プロジェクトトラッカー
D:\AI\projects\<slug>\README.md — プロジェクトごとのドキュメント
未インストール(リクエストによりインストール可能)
SDXL ベース、FLUX、ピクセルアート LoRA、SDXL ControlNet、H3 FL2VA、アップスケールモデル(ESRGAN/SeedVR2)、テクスチャ LoRA、Kohya トレーニングツール、Krita AI Diffusion、Aseprite/Pixeloroma。