ComfyUI カスタムノードの requirements.txt が未インストールの場合の修復手順
requirements.txt 依存関係が適切な Python 環境にインストールされていないためにロードが失敗する ComfyUI カスタムノードの修復。
コミュニティ知識
本ページの内容は、一般的な ComfyUI 故障排査パターンに基づいています。すべての環境での検証は行われていません。パッケージを変更する前に、必ず環境のバックアップを作成してください。
ComfyUI の起動ログでカスタムノードに IMPORT FAILED（ModuleNotFoundError が原因）と表示されている場合、最も一般的な原因は、そのノードの requirements.txt がインストールされていないことです。
カスタムノードを custom_nodes/ ディレクトリにクローンまたはダウンロードしただけでは、コードがコピーされただけです。そのコードが依存する Python パッケージは、別途インストールする必要があります。
2026年6月29日までの 30日間の Wonderful Launcher テレメトリデータによると、欠落したノードの依存関係の修復問題が繰り返し発生しています。ユーザーによるノード欠落、クローンの試行、依存関係のインストール結果、およびその後の ModuleNotFoundError イベントは一連のトラブルの流れであり、個別の問題として捉えるべきではありません。
クイック回答
GitHub 経由の Windows ポータブル版の場合：
.\python_embeded\python.exe -s -m pip install -r ComfyUI\custom_nodes\<node-name>\requirements.txt
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-buildインストールする前に、必ず requirements.txt ファイルの中身を読み、リスクのあるパッケージ変更がないか確認してください。
エラーの現れ方
IMPORT FAILED: ComfyUI-ExampleNode
Traceback (most recent call last):
File "...\custom_nodes\ComfyUI-ExampleNode\__init__.py", line 4, in <module>
import somepackage
ModuleNotFoundError: No module named 'somepackage'ノードフォルダは custom_nodes/ に存在していますが、somepackage がインストールされていないためにインポートが失敗しています。
典型的な欠落モジュールのパターン
以下のモジュールは、ランチャーのテレメトリデータで出現頻度が高いものです。同じノードを再クローンする前に、順次確認することをお勧めします：
| 欠落モジュール | 該当する主なワークフロー | 確認すべき事項 |
|---|---|---|
triton | 加速化、SageAttention、動画、LLM | インストール前に、その依存関係がオプションか必須かを確認 |
sageattention | Wan/動画加速、強制 Attention フラグ | 不要な場合は、起動引数から強制フラグを削除 |
onnx / onnxruntime | 顔交換、姿勢検出、DWPose、ReActor、IPAdapter | 通常は CPU 版 onnxruntime を優先し、必要な場合のみ GPU 版を検討 |
llama_cpp | GGUF プロンプト支援、ローカル LLM/VLM ノード | パッケージ名は通常 llama-cpp-python です |
nunchaku | Nunchaku ベースの FLUX/Qwen/SANA | PyPI に登録されている無関係な nunchaku をインストールしない |
sox / decord | 音声および動画補助ノード | 闇雲にインストールせず、必要なノードのソースを確認 |
groundingdino / segment_anything | 物体検出、セグメンテーション、マスク | SAM/GroundingDINO 導入ガイド を参照 |
dlib / nvvfx | 顔/動画エフェクト | OS やプラットフォーム対応が重要。プラグインの README を確認 |
該当するモジュールが上記にない場合も基本ルールは同じです。まずロードに失敗したプラグインを特定し、必要な最小限の依存パッケージを ComfyUI の Python 環境にインストールします。
原因分析
- 手動で git clone したが pip install を忘れた：リポジトリをクローンしただけで依存関係を入れていない
- ComfyUI Manager の処理失敗：Manager がクローンは行ったものの、依存関係のインストールで静かに失敗した
- 環境の再構築：ComfyUI の再インストールやポータブル版の更新により、既存のインストール済みパッケージが消去された
- 誤った Python 環境へのインストール：依存関係がシステム全体の Python に入ってしまい、ComfyUI の内蔵 Python に反映されていない
- requirements.txt が存在しない：一部のノードは README 内にのみテキストで依存関係を記載しており、ファイルを提供していない
解決手順
ステップ 1：失敗しているノードの特定
ComfyUI の起動ログで IMPORT FAILED と表示されている行を確認します。エラーが出ているカスタムノードフォルダ名と、欠落しているモジュール名が表示されています。
ステップ 2：requirements.txt の確認
以下を実行してファイルの存在を確認します：
dir ComfyUI\custom_nodes\<node-name>\requirements.txt存在する場合はステップ 3 に進みます。存在しない場合は、該当ノードの GitHub README を読み、手動インストールの指示に従ってください。
ステップ 3：インストール前の requirements.txt の精読
以下のコマンドなどで内容を確認します：
type ComfyUI\custom_nodes\<node-name>\requirements.txt以下のリスクのある記述に注意してください：
| 記述内容 | リスク |
|---|---|
torch, torchvision, torchaudio | CUDA 対応の既存の PyTorch 環境が CPU 版に上書きされるリスク |
バージョン固定なし（== や >= なし） | 互換性のない最新版がインストールされるリスク |
opencv-python-headless があるのに opencv-python を要求 | DLL の競合が発生するリスク |
| バージョン固定が古すぎる、または新しすぎる | 他のカスタムノードと競合するリスク |
ファイルが安全に見える場合は進みます。もし torch などのコアパッケージが含まれている場合は、ファイル全体のインストールではなく、不足している個別のパッケージのみを手動インストールすることを検討してください。
ステップ 4：依存関係のインストール
Windows ポータブル版の場合：
.\python_embeded\python.exe -s -m pip install -r ComfyUI\custom_nodes\<node-name>\requirements.txt手動仮想環境（venv）の場合：
python -m pip install -r custom_nodes/<node-name>/requirements.txtステップ 5：パッケージの個別インストール（安全策）
ファイル全体をインストールして環境が壊れるのを防ぐため、欠落している特定のモジュールのみを個別にインストールします：
.\python_embeded\python.exe -s -m pip install somepackagerequirements.txt に torch や numpy などのコアパッケージが記載されている場合は、この個別インストールが推奨されます。
ステップ 6：起動検証
ComfyUI を再起動し、IMPORT FAILED の表示が消えたことを確認します：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build関連ガイド
参照元
実際の ComfyUI 環境で起きている問題なら、まず無料で Wonderful Launcher を使って確認してください。ランチャー内の修復フロー、タスクログ、実行環境チェックを一か所で確認できます。クレジットは画像生成と従量ツール用です。
Wonderful Launcher をダウンロードクレジットプランを見るDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.