ComfyUI の ModuleNotFoundError / No module named エラーの修復

パッケージ名、Python 環境、カスタムノード依存関係、CUDA / PyTorch バージョン競合から ComfyUI の ModuleNotFoundError および No module named エラーを診断・解決。

ComfyUI 起動時に ModuleNotFoundError: No module named ... が出力された場合、本ページはそれぞれの原因別エラーを解決するための総合ナビゲーションハブです。不足しているモジュール名（エラーメッセージに出てくる名称）がすでにわかっている場合は、直接以下の個別解説リンクへ移動してください。

Python パッケージの欠落を解決する上で最も重要なのは、「どの Python 環境に対してパッケージをインストールするか」 を正確に指定することです。

Windows ポータブル版をご利用の場合、コマンドは必ず内蔵の Python を指して実行してください：

.\python_embeded\python.exe -s -m pip install <パッケージ名>

手動でインストールした Git / venv 版をご利用の場合は、仮想環境を有効化した状態で実行してください：

python -m pip install <パッケージ名>

クイック診断表

起動ログの表示	主な原因	優先確認事項
`custom_nodes` 内のスクリプトで `ModuleNotFoundError`	カスタムノードが要求する依存パッケージの欠如	該当カスタムノードフォルダ内の `requirements.txt` を確認
`ComfyUI\comfy\...` 内のスクリプトで `ModuleNotFoundError`	ComfyUI 本体のコア依存パッケージの欠如または競合	ComfyUI ルートの `requirements.txt` を確認
`pip install` に成功したのに起動エラーが消えない	誤った Python 環境（システム全体など）にインストールした	起動用 Python パスで `pip show <パッケージ名>` を実行
再起動するたびに不足しているモジュール名が変わる	1つのエラーを修復したことで、その次に控えていた別のエラーが露出した	焦らずに新しく出た最初のエラーの修復を続ける
CUDA、DLL、または wheel に関連するエラーが出る	パッケージに特定の GPU / コンパイル依存関係がある	パッケージ変更の前に PyTorch / CUDA の整合性を確認

発生頻度の高い欠落モジュール一覧

テレメトリデータおよびサポート事例において、発生頻度が非常に高いモジュール一覧です：

不足しているモジュール	主な出現箇所	個別解決ガイド
`triton`	FLUX、高性能サンプラー、一部の動画生成系ノード	修复 `triton` 问题
`sageattention`	Wan-Video 等の動画生成加速スタック	修复 `sageattention` 问题
`onnx` / `onnxruntime`	DWPose、顔検出、ReActor、IP-Adapter などの ONNX 依存ノード	修复 `onnx` 和 `onnxruntime`
`llama_cpp`	GGUF プロンプト、ローカル LLM / VLM 連携ノード	修复 `llama_cpp` 问题
`insightface`	顔交換（ReActor）、InstantID、顔詳細補正ノード	修复 `insightface` 问题
`cv2`	画像処理、動画編集、ControlNet などの画像読込ノード	修复 `cv2` 问题
`nunchaku`	Nunchaku 量化 FLUX/Qwen/SANA ワークフロー	修复 `nunchaku` 问题
`kornia`	コア後処理、Canny フィルタ、形態学系ノード	修复 `kornia` 问题
`spandrel`	超解像アップスケーラモデル読込（`nodes_upscale_model.py`）	修复 `spandrel` 问题
`simpleeval`	数式計算ノード（`nodes_math.py`）	修复 `simpleeval` 问题
`pydantic_settings`	`pyproject.toml` 設定ファイルの解析とインポート	修复 `pydantic_settings` 问题
`yaml` / `PIL`	パッケージ名間違いの罠：`PyYAML` / `Pillow` をインストールすべき	修复 `yaml` または修复 `PIL`
`safetensors`	Safetensors ファイルの読込用ライブラリ	修复 `safetensors` Python 包
`einops`	テンソル演算、ControlNet やモデルのコアレイヤー	修复 `einops` 问题
`scipy`	数値解析スタック、音声/動画処理系ノード	修复 `scipy` 问题
`torchsde`	SDE 確率微分方程式サンプラー（KSampler 関連）	修复 `torchsde` 问题
`av`	PyAV 動画フレームデコード・エンコード処理	修复 `av` 问题
`aiohttp` / `requests`	ネットワーク通信、Web API 連携系ノード	修复 `aiohttp` または修复 `requests`

インポート名と PyPI パッケージ名の一致確認

Python のコード上で import する際の名前と、pip install する際のパッケージ名は必ずしも一致しません。以下は典型的な罠です：

インポート名（ログに出る名前）	実際のパッケージ名	インストールコマンド例
`cv2`	`opencv-python-headless`	`pip install opencv-python-headless`
`yaml`	`PyYAML`	`pip install PyYAML`
`PIL`	`Pillow`	`pip install Pillow`
`segment_anything`	`segment-anything`	`pip install segment-anything`
`llama_cpp`	`llama-cpp-python`	`pip install llama-cpp-python`

Related errors

クイック診断表

起動ログの表示	主な原因	優先確認事項
`custom_nodes` 内のスクリプトで `ModuleNotFoundError`	カスタムノードが要求する依存パッケージの欠如	該当カスタムノードフォルダ内の `requirements.txt` を確認
`ComfyUI\comfy\...` 内のスクリプトで `ModuleNotFoundError`	ComfyUI 本体のコア依存パッケージの欠如または競合	ComfyUI ルートの `requirements.txt` を確認
`pip install` に成功したのに起動エラーが消えない	誤った Python 環境（システム全体など）にインストールした	起動用 Python パスで `pip show <パッケージ名>` を実行
再起動するたびに不足しているモジュール名が変わる	1つのエラーを修復したことで、その次に控えていた別のエラーが露出した	焦らずに新しく出た最初のエラーの修復を続ける
CUDA、DLL、または wheel に関連するエラーが出る	パッケージに特定の GPU / コンパイル依存関係がある	パッケージ変更の前に PyTorch / CUDA の整合性を確認

発生頻度の高い欠落モジュール一覧

テレメトリデータおよびサポート事例において、発生頻度が非常に高いモジュール一覧です：

不足しているモジュール	主な出現箇所	個別解決ガイド
`triton`	FLUX、高性能サンプラー、一部の動画生成系ノード	修复 `triton` 问题
`sageattention`	Wan-Video 等の動画生成加速スタック	修复 `sageattention` 问题
`onnx` / `onnxruntime`	DWPose、顔検出、ReActor、IP-Adapter などの ONNX 依存ノード	修复 `onnx` 和 `onnxruntime`
`llama_cpp`	GGUF プロンプト、ローカル LLM / VLM 連携ノード	修复 `llama_cpp` 问题
`insightface`	顔交換（ReActor）、InstantID、顔詳細補正ノード	修复 `insightface` 问题
`cv2`	画像処理、動画編集、ControlNet などの画像読込ノード	修复 `cv2` 问题
`nunchaku`	Nunchaku 量化 FLUX/Qwen/SANA ワークフロー	修复 `nunchaku` 问题
`kornia`	コア後処理、Canny フィルタ、形態学系ノード	修复 `kornia` 问题
`spandrel`	超解像アップスケーラモデル読込（`nodes_upscale_model.py`）	修复 `spandrel` 问题
`simpleeval`	数式計算ノード（`nodes_math.py`）	修复 `simpleeval` 问题
`pydantic_settings`	`pyproject.toml` 設定ファイルの解析とインポート	修复 `pydantic_settings` 问题
`yaml` / `PIL`	パッケージ名間違いの罠：`PyYAML` / `Pillow` をインストールすべき	修复 `yaml` または修复 `PIL`
`safetensors`	Safetensors ファイルの読込用ライブラリ	修复 `safetensors` Python 包
`einops`	テンソル演算、ControlNet やモデルのコアレイヤー	修复 `einops` 问题
`scipy`	数値解析スタック、音声/動画処理系ノード	修复 `scipy` 问题
`torchsde`	SDE 確率微分方程式サンプラー（KSampler 関連）	修复 `torchsde` 问题
`av`	PyAV 動画フレームデコード・エンコード処理	修复 `av` 问题
`aiohttp` / `requests`	ネットワーク通信、Web API 連携系ノード	修复 `aiohttp` または修复 `requests`

インポート名と PyPI パッケージ名の一致確認

Python のコード上で import する際の名前と、pip install する際のパッケージ名は必ずしも一致しません。以下は典型的な罠です：

インポート名（ログに出る名前）	実際のパッケージ名	インストールコマンド例
`cv2`	`opencv-python-headless`	`pip install opencv-python-headless`
`yaml`	`PyYAML`	`pip install PyYAML`
`PIL`	`Pillow`	`pip install Pillow`
`segment_anything`	`segment-anything`	`pip install segment-anything`
`llama_cpp`	`llama-cpp-python`	`pip install llama-cpp-python`

ComfyUI の ModuleNotFoundError / No module named エラーの修復

Related errors

クイック診断表

発生頻度の高い欠落モジュール一覧

インポート名と PyPI パッケージ名の一致確認

関連ガイド

目次

ComfyUI の ModuleNotFoundError / No module named エラーの修復

Related errors

クイック診断表

発生頻度の高い欠落モジュール一覧

インポート名と PyPI パッケージ名の一致確認

関連ガイド

目次