パッケージを導入したのに ComfyUI で ModuleNotFoundError が出る

症状と対象範囲

ターミナルでのインストール成功だけでは、ComfyUI が同じ Python を使っているとは分かりません。依存関係を変更する前に、読み込み名、配布パッケージ名、実行中の Python を分けて確認します。

検索の手掛かりとなるエラーの断片です。モジュール名やファイル名は環境によって変わります。

ModuleNotFoundError
No module named

出典から確認できること

ComfyUI のカスタムノード問題のガイドは、ノードの読み込み失敗と依存関係の問題を説明しています。Windows Portable の公式ガイドに示される組み込み Python のフォルダー名は、文字どおり python_embeded です。システムの Python に導入したパッケージを、この Python から使えるとは限りません。pip check の公式資料によると、同コマンドはインストール済みパッケージの宣言された依存関係の整合性を調べます。すべての import や ComfyUI の動作を実行して検証するものではありません。

区別すべき状況

1. システムの Python に導入したが、実際の ComfyUI は Portable の組み込み Python または別の仮想環境で動いている。

2. ノードのコードは存在しても、対応する版の依存パッケージの導入が失敗したか、まだ導入されていない。

3. エラー中の import 名と配布パッケージ名が異なる。または、そのパッケージのさらに奥にあるネイティブ依存関係で DLL や ABI のエラーが起きている。

確認手順

以下は引用した資料に基づく編集上の手順であり、あなたの環境で原因が確定したことを意味しません。

手順 1. 最初の traceback と該当するカスタムノードのリポジトリを確認します。最後の一行だけでパッケージ名を推測せず、その版の要件を読みます。

手順 2. 実際に ComfyUI を起動している Python の sys.executable と python -m pip --version を確認します。下の例は Windows Portable の構成であり、Desktop アプリや仮想環境にはそのまま当てはまりません。

手順 3. その環境に必要だと特定できた、対応版の依存パッケージだけを導入します。ダウンロードの完了とインストールの完了も区別します。

手順 4. 対象の import を確かめ、ComfyUI を再起動してノードが登録されたか確認します。続けて DLL や ABI のエラーが出た場合は別の問題として調べ、同じパッケージを繰り返し導入しないでください。

コマンド例

次は Portable パッケージのルートから Windows PowerShell で使う読み取り中心の例です。このサイトはあなたのマシンで実行していません。

.\python_embeded\python.exe -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -m pip --version
.\python_embeded\python.exe -m pip check

完了の確認

意図した Python で依存パッケージを読み込めて、ノードが登録されることを確認します。使用した版を記録し、必要な操作も試します。pip check の終了コードだけでは確認できません。

注意点

無関係のパッケージを一括導入するスクリプトは避けてください。管理ランチャーや仮想環境では実行ファイルの場所が異なります。

参照した原文資料

• ComfyUI カスタムノード問題のガイド（英語）
• ComfyUI Windows Portable ガイド（英語）
• pip check の公式資料（英語）

資料を確認した日付は 2026-09-25 です。この記事はインストールや GPU ワークフローを実機で検証した記録ではありません。

関連記事

• Windows の DLL load failed：不足しているネイティブ拡張を調べる（英語）
• pip ResolutionImpossible：依存関係の競合を整理する（英語）