Community画像github.com

ComfyUI セットアップ

Windows (RTX 3090) 上での ComfyUI のローカルインストール、モデル管理、ワークフロー、トラブルシューティングを行うスキルです。

ComfyUI セットアップ とは?

このスキルは、Windows 10 Pro、RTX 3090 24GB、28GB RAM を搭載したマシン上で ComfyUI 0.44.0 ポータブル版(CUDA 13、Python 3.13)を管理・運用するための包括的なガイドです。関連モデルのフォルダ構造(チェックポイント、拡散モデル、VAE、LoRA など)と、それらをワークフローで正しく読み込むためのローダーノードの対応表を示します。特に ComfyUI 0.44.0 では `widgets_values` と `widgets_values_named` の両方を更新する必要がある点、モデル追加後の再起動の重要性、H3 ビデオ生成のための特殊フラグ、int8/FP8 ビルドの使用推奨など、実際の運用で注意すべきルールを多数含んでいます。Z-Image Turbo、Nova Anime XL、MiniMax H3 など主要なモデルの設定例と、よくあるエラーの解決方法もカバーしており、AI 画像・動画・3D 生成をローカルで安定して行いたいエージェントや開発者に役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/konqiDAM/void-skills/tree/main/comfyui-setup

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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
VAED:\AI\models\vae\VAELoader
ControlNet/パッチD:\AI\models\model_patches\ModelPatchLoader
LoRAD:\AI\models\loras\LoraLoader
CLIP visionD:\AI\models\clip_vision\CLIPVisionLoader
アップスケールD:\AI\models\upscale_models\UpscaleModelLoader
背景除去D:\AI\models\background_removal\LoadBackgroundRemovalModel
3DD:\AI\models\diffusion_models\ + vae\ネイティブ3Dノード

重要なルール

  1. widgets_values と widgets_values_nameded の両方をワークフロー内のモデル名変更時に更新する必要があります。ComfyUI 0.44.0 では widgets_values_named が実際の値として使用されます。
  2. モデル追加後は ComfyUI を再起動してください(モデルリストは起動時にキャッシュされます)。
  3. ブラウザキャッシュ: 「モデルが見つかりません」と表示されたら、ページをリロード(F5)し、ワークフローを開き直してください。
  4. int8/FP8 ビルドが 28GB RAM では必要です。BF16 には 40GB 必要です。
  5. H3 には --disable-pinned-memory --fp16-intermediates フラグが必要です。
  6. モデルタイプを混在させないでください。 Z-Image は UNET/CLIP/VAE(個別)を使用します。SDXL チェックポイントは CheckpointLoaderSimple を使用します。
  7. extra_model_paths.yaml ではフォワードスラッシュを使用します: D:/AI/models/。
  8. HF/Torch キャッシュは D: ドライブに置く必要があります(起動バッチで設定)。
  9. MarkdownNote ノードにモデル名がテキストで含まれている場合があります。誤った「モデルが見つかりません」警告を避けるため、それらをクリーンにしてください。

新規モデルのインストール

  1. D:\AI\downloads\ に curl でダウンロード。
  2. D:\AI\models\ 配下の正しいフォルダに移動。
  3. 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')"
    
  4. ComfyUI を再起動。
  5. http://127.0.0.1:8188/object_info/<LoaderNode> でローダーが認識しているか確認。
  6. 既存テンプレートからワークフローを作成し、widgets_values と widgets_values_named の両方を更新。
  7. API 経由でテスト(test_zimage.py のパターンを参照)。
  8. 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 Turboint8 UNET + FP8 エンコーダ + ae.safetensors8-9 ステップ、CFG 1.0、res_multistep、simple、1024-1344px
Nova Anime XL v19NovaAnimeILV190.safetensors(SDXL)28 ステップ、CFG 5、euler_ancestral、normal、CLIP skip 2
Prefect Pony XL v6PrefectPonyXLV6.safetensors(Pony/SDXL)28 ステップ、CFG 6、euler_ancestral、normal、CLIP skip 2
Pixal3D/TRELLIS.2int8 UNET + VAE + DINOv3 + BiRefNet + MoGe1024px、boolean: off=Pixal3D、on=TRELLIS.2
MiniMax H3pruned int8 + NVFP4 エンコーダ + ビデオ/オーディオ VAE5秒 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。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル