ComfyUI の No module named エラーを直す

ComfyUI で ModuleNotFoundError: No module named ... が出た場合、見えている「足りない Python パッケージ」は診断の一部にすぎません。 本当に重要なのは ComfyUI を起動した Python 環境がどれか です。

公式 Windows portable パッケージでは、多くの修復コマンドは次の形で実行する必要があります。

.\python_embeded\python.exe -s -m pip ...

手動 Git インストールなら、ComfyUI を起動しているのと同じ venv を有効化してから：

python -m pip ...

すぐに見るポイント

Step 1: まず「何が足りないか」を正確にコピーする

推測したパッケージ名ではなく、ログの行そのものから始めます。

ModuleNotFoundError: No module named 'sageattention'

モジュールの import 名と pip のパッケージ名は必ずしも一致しません。 例えば cv2 は OpenCV 系パッケージから来ることが多く、segment_anything は segment-anything 由来です。

Step 2: ComfyUI を起動した Python を見つける

Windows portable：

.\python_embeded\python.exe -s -m pip --version
.\python_embeded\python.exe -s -m pip show <package-name>

手動 venv：

python -m pip --version
python -m pip show <package-name>

出力パスが ComfyUI の環境を指している必要があります。 system Python を指しているなら、修復場所が間違っています。

Step 3: その不足パッケージは本当に致命的か

足りない optional acceleration パッケージを全部すぐ直す必要はありません。

Step 4: 既に個別ガイドがあるなら狭く直す

• No module named 'sageattention'
• No module named 'cv2'
• No module named 'insightface'
• No module named 'onnx' / 'onnxruntime'
• No module named 'transformers'
• No module named 'torch'
• No module named 'triton'

関連しそうなものを一気に全部入れないでください。 1 つ直したら再起動し、次の最初のエラーを読みます。

Step 5: 修復後に必ず import を検証する

再起動前に、同じ Python で import を直接確認します。

python -c "import <module_name>; print('import ok')"

Windows portable：

.\python_embeded\python.exe -s -c "import <module_name>; print('import ok')"

その後 ComfyUI を再起動します。 元の ModuleNotFoundError が消え、対象のノードや workflow が読み込めれば前進です。新しい不足パッケージが出た場合は、それを次の最初の阻害要因として扱います。

Wonderful Launcher に切り替えるべきタイミング

手動パッケージ修復が向いているのは、「不足 import が 1 つはっきりしている時」です。 次のような状態になると、手作業は急に危険になります。

• 複数のカスタムノードが起動時に同時失敗する
• pip check が毎回新しい衝突を返す
• プラグイン修正中に CUDA や Torch まで崩れた
• どの Python が ComfyUI を起動したか自信がない
• モデルや設定を保持したい

関連ガイド

• ComfyUI Dependency Conflicts
• ComfyUI Plugin Import Failed
• ComfyUI Python Embedded Explained
• Install Custom Nodes Safely
• Where to Put Safetensors in ComfyUI