ComfyUI ガイド
ComfyUI の起動失敗、欠落パッケージ、プラグインエラー、依存関係の衝突を解決します。
やりたいことから探す
Wonderful Launcher クイックスタート
ComfyUI ランタイムパッケージをインストールまたはインポートし、Home から起動して、起動ログを確認し、埋め込み Workspace を開きます。
ComfyUI が起動しない時の切り分け
プラグイン破損、依存漂移、欠落パッケージ、helper ファイル異常などによる起動失敗を分類して直す。
ComfyUI Plugin Import Failed: カスタムノード導入失敗の直し方
ComfyUI の plugin import failed、赤ノード、依存漂移、カスタムノード破損を、環境再インストールなしで修復する手順。
ComfyUI 依存競合を再インストールなしで直す
カスタムノード導入後の依存競合、Torch の降格、pip 衝突、プラグイン導入失敗を最小修復で戻す。
ComfyUI の No module named エラーを直す
ComfyUI の ModuleNotFoundError / No module named を、パッケージ名、Python 環境、カスタムノード依存、CUDA / PyTorch 不整合の観点で切り分けます。
ComfyUI で safetensors をどこに置くか
checkpoint、LoRA、VAE、ControlNet、Flux、text encoder、upscaler などの `.safetensors` を正しいフォルダに置くための早見表。
ComfyUI トラブルシュート決定木
起動失敗、プラグイン競合、依存エラー、モデル問題を順番に切り分けるガイド。
カテゴリから探す
はじめに
ComfyUI が初めてならここから始めてください。
トラブルシューティング
よくある問題を解決します。
不足パッケージ
Python の import エラーを直します。
ComfyUI で No module named 'torch' が出る時の修復
portable、venv、managed install で torch が消えた時に、正しい Python 環境で戻し、CUDA 版かどうかまで確認する。
ComfyUI の No module named エラーを直す
ComfyUI の ModuleNotFoundError / No module named を、パッケージ名、Python 環境、カスタムノード依存、CUDA / PyTorch 不整合の観点で切り分けます。
ComfyUI で No module named 'cv2' が出る時の直し方
OpenCV の不足や競合で発生する cv2 エラーを、正しい Python 環境と単一 OpenCV flavor の原則で修復する。
ComfyUI で No module named 'insightface' が出る時の直し方
ReActor、IPAdapter FaceID、InstantID、PuLID などで使う insightface 不足を Windows 環境で修復する手順。
ヘルプが必要ですか？
この問題が実際の ComfyUI 環境に影響しているなら、まず Wonderful Launcher で現在のマシンを確認し、ドキュメントを見ながら修復方針を決めてください。