1. 問題の概要：ノード更新時の依存関係エラー
ComfyUIの強力な拡張機能である「ComfyUI Manager」を使用して、カスタムノードを更新またはインストールする際、以下のようなエラーメッセージが表示され、プロセスが失敗することがあります。
ERROR: Cannot install -r requirements.txt (line 3) and package==1.2.3 because these package versions have conflicting dependencies.
The conflict is caused by:
some-package 2.0.0 depends on dependency-package=3.1.0
あるいは、更新後にComfyUIの起動自体が失敗し、ターミナルにImportErrorやModuleNotFoundErrorが表示されることもあります。この問題は、異なるカスタムノードが互換性のないバージョンの同じPythonパッケージに依存している場合に発生します。ComfyUI Managerは各ノードのrequirements.txtを個別にインストールしようとするため、グローバルなPython環境でバージョン競合が起きてしまうのです。
2. 原因の解説：依存関係の地獄（Dependency Hell）
この問題の根本原因は、Pythonのパッケージ管理システムの特性にあります。ComfyUIは通常、単一のPython環境（ComfyUI/python_embeded/ またはシステムのグローバル環境）で全てのノードを実行します。各カスタムノードはrequirements.txtやpyproject.tomlで必要なライブラリとそのバージョンを指定します。
問題が発生する典型的なシナリオは以下の通りです：
- シナリオA：後方互換性のないメジャーアップデート
既にインストールされているノードAがtorchvision==0.15.2に依存している状態で、新しくインストールするノードBがtorchvision==0.16.0を要求すると、競合が発生します。 - シナリオB：間接的な依存関係の衝突
ノードCがnumpy<1.24.0に依存するパッケージXを必要とし、ノードDがnumpy>=1.24.0に依存するパッケージYを必要とする場合、単一のnumpyバージョンでは両方を満たせません。 - シナリオC：Managerの自動更新による破壊的変更
ComfyUI Managerの「Update All」機能を使用した際、あるノードの更新が他のノードの動作に必要な古いパッケージバージョンを上書きしてしまうことがあります。
ComfyUIの環境は多くの異なる開発者によって作られたノードの集合体であるため、この種の依存関係の衝突は非常に頻繁に発生します。
3. 解決方法：ステップバイステップでの対処法
ここでは、問題の深刻度に応じた段階的な解決方法を紹介します。
ステップ1： エラーの特定と影響範囲の確認
まず、どのパッケージが競合しているのかを正確に把握します。ComfyUI Managerのインストールログや、ComfyUI起動時のターミナルエラーを仔細に確認してください。競合しているパッケージ名と、それぞれのノードが要求するバージョン範囲をメモします。
次に、該当のパッケージに依存しているノードを特定します。ComfyUI/custom_nodes/ディレクトリ内の各ノードフォルダにあるrequirements.txtやpyproject.tomlを検索（grepコマンド等で）するのが有効です。
ステップ2： シンプルな解決策 – 手動でのバージョン調整
競合が単純な場合（例えば、一方のノードが柔軟なバージョン指定をしている場合）は、手動でインストールするバージョンを調整できます。
# ComfyUIのPython環境にアクセス
cd /path/to/ComfyUI
# 仮想環境を使用している場合は activate する
# .python_embededpython.exe -m pip install (Windows)
./python_embeded/python -m pip install "package-name==互換性のあるバージョン"
その後、問題のノードをComfyUI Managerから再インストールします。Managerは既にインストール済みのパッケージを検知し、インストールをスキップすることがあります。
ステップ3： 高度な解決策 – 依存関係の互換性調査と強制インストール
手動調整で解決しない場合、互換性のあるバージョンを見つける必要があります。PyPIのパッケージページや、以下のコマンドで依存関係ツリーを調査します。
# 現在インストールされているパッケージの依存関係を表示
pip show "package-name"
# または、pipdeptreeツールをインストールして詳細を確認
./python_embeded/python -m pip install pipdeptree
./python_embeded/python -m pipdeptree
どうしても競合が解消できない場合、最後の手段として--force-reinstallや--no-depsオプションを使って、特定のノードの依存関係を無視してインストールする方法があります。この方法は他のノードを壊す可能性が高いため、注意が必要です。
cd /path/to/ComfyUI/custom_nodes/Problematic-Node
../python_embeded/python -m pip install --force-reinstall --no-deps -r requirements.txt
インストール後、ノードが機能するかどうかを必ずテストしてください。
ステップ4： 根本的解決策 – 仮想環境またはDockerの利用
頻繁にノードの更新や追加を行う場合、最も堅牢な解決策はComfyUI用の独立した仮想環境を作成することです。これにより、ComfyUIの環境を他のプロジェクトから隔離できます。
# venvを使用した例 (ComfyUIディレクトリ外で実行)
python -m venv comfyui_venv
# Windows
comfyui_venvScriptsactivate
# Linux/Mac
source comfyui_venv/bin/activate
# 仮想環境内にComfyUIの依存関係をインストール
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121 # CUDA 12.1の場合
cd /path/to/ComfyUI
pip install -r requirements.txt
あるいは、ComfyUI公式が推奨するDockerイメージを使用する方法もあります。Dockerは完全に隔離された環境を提供するため、依存関係の競合から根本的に解放されます。
4. 予防策とベストプラクティス
問題を未然に防ぐための習慣を身につけましょう。
- バックアップの習慣化: 大量のノードを更新する前には、
ComfyUI/custom_nodes/ディレクトリ全体と、pip listの出力をバックアップします。 - 段階的な更新: 「Update All」は便利ですが危険です。重要なノードやワークフローの核となるノードから個別に更新し、その都度動作確認を行います。
- 環境の分離: 実験用のComfyUI環境と、安定して作業用の環境を分けて構築することを検討します。
- ノード作者への情報提供: 互換性の問題を見つけたら、GitHubのIssueなどでノードの開発者に報告します。多くの場合、バージョン指定が緩和される可能性があります。
5. まとめ・補足情報
ComfyUI Managerによるノード更新時のパッケージ競合は、活発なコミュニティと多様なカスタムノードがもたらす「成長の痛み」とも言えます。この問題に対処するには、「特定→調査→段階的解決→根本的対策」という流れが有効です。
最も重要なのは、問題が発生した際にパニックにならず、エラーメッセージを手がかりに冷静に原因を特定することです。Pythonのパッケージ管理に関する基礎知識（バージョン指定子の意味: ==, >=, ~=など）を身につけておくと、トラブルシューティングが格段に楽になります。
最後に、ComfyUIの環境が完全に破損して起動できないような最悪の事態に備え、本体とカスタムノードをGitで管理する、または定期的に全体のバックアップを取ることを強くお勧めします。創造的なAI画像生成に集中するためにも、開発環境の安定性は常に意識しておきましょう。