1. 問題の概要：ノード更新後の依存関係エラー

ComfyUI Managerは、カスタムノードのインストールや更新を非常に便利に行えるツールです。しかし、Manager経由でノードを更新した後、以下のようなエラーが発生し、ワークフローの実行に失敗することがあります。

ModuleNotFoundError: No module named 'torch'
ImportError: cannot import name 'some_function' from 'some_library'
AttributeError: module 'numpy' has no attribute 'float'

また、ComfyUIの起動時や特定ノードの読み込み時に、コンソールに次のような警告やエラーが表示されるケースも典型的です。

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed.
Version conflict: Package-A requires Package-B>=2.0.0, but you have Package-B 1.8.0.

この問題は、更新されたカスタムノードが要求するPythonパッケージのバージョンが、既にシステムにインストールされている他のノードやComfyUI本体の依存パッケージと互換性がない場合に発生します。結果として、一部のノードが機能しなくなったり、最悪の場合はComfyUI自体が起動不能になることもあります。

2. 原因の解説：依存関係の地獄（Dependency Hell）

この問題の根本原因は、いわゆる「依存関係の地獄（Dependency Hell）」です。ComfyUIのエコシステムは以下のような構造になっており、ここに競合が生じます。

2.1 競合が発生する3つの層

1. ComfyUI本体の依存関係: ComfyUI自体が特定バージョンのPyTorch、numpy、その他ライブラリに依存しています。これらは通常、requirements.txtファイルで管理されています。

2. カスタムノード間の依存関係: 異なる開発者によって作成された複数のカスタムノードが、互いに互換性のないバージョンの同一パッケージを要求することがあります。例えば、Node-Aがopencv-python==4.5.0を要求し、Node-Bがopencv-python>=4.8.0を要求する場合です。

3. グローバルPython環境との競合: システム全体のPython環境（pip install --globalでインストールされたパッケージ）に既に存在するパッケージと、ComfyUIが仮想環境内で要求するパッケージが衝突します。

2.2 ComfyUI Managerの更新メカニズム

ComfyUI Managerは、ノードの更新時にそのノードのrequirements.txtやinstall.pyに記載された依存パッケージを単純にpip installします。この時、既存のパッケージを強制的にアップグレードまたはダウングレードしてしまうため、他のノードが要求するバージョンとの整合性が崩れるのです。

3. 解決方法：ステップバイステップガイド

問題を解決し、安定した環境を構築するための実践的な手順を紹介します。

3.1 ステップ1：問題の特定と環境のバックアップ

まず、どのパッケージのどのバージョンが競合しているのかを特定します。ComfyUIのコンソールログを仔細に確認し、エラーメッセージの直前にあるpip installやバージョンチェックのログを探します。

作業を始める前に、現在のPython環境の状態をバックアップします。これは後でロールバックする際に役立ちます。

# 現在インストールされているパッケージとそのバージョンをリスト化して保存
cd /path/to/ComfyUI
pip freeze > requirements_backup_$(date +%Y%m%d).txt

3.2 ステップ2：仮想環境の活用（最も推奨される方法）

ComfyUIをシステムのグローバルPython環境から完全に隔離することが最善策です。公式でも推奨されている通り、venvやcondaなどの仮想環境を使用してください。

# 1. 仮想環境の作成（ComfyUIディレクトリの一つ上などで実行）
cd /path/to/parent_directory
python -m venv comfyui_venv

# 2. 仮想環境の有効化（Windows）
comfyui_venvScriptsactivate
# 仮想環境の有効化（macOS/Linux）
source comfyui_venv/bin/activate

# 3. 仮想環境内でComfyUIの依存関係をインストール
cd /path/to/ComfyUI
pip install -r requirements.txt

# 4. 以降、ComfyUIを起動する前には必ず仮想環境を有効化する

仮想環境内でComfyUI Managerを使用してノードを更新すれば、システムの他の部分への影響を心配する必要はありません。

3.3 ステップ3：競合パッケージの手動調整

仮想環境を使用していても、ノード間で競合が発生することがあります。その場合は、互換性のあるバージョンを手動で探してインストールします。

例：opencv-pythonとonnxruntimeで競合が発生した場合

# 現在のバージョンを確認
pip list | grep -E "opencv|onnxruntime"

# 互換性のあるバージョンの組み合わせを探す（エラーログやノードのREADMEを参照）
# 例えば、多くのノードがサポートする安定版にダウングレード
pip install "opencv-python==4.8.1.78" "onnxruntime==1.16.0"

# または、問題を起こしている特定のノードのみ、互換性レイヤを使用する（後述の3.4参照）

3.4 ステップ4：問題のあるノードの隔離と互換性レイヤの使用

特定のノードだけが非常に新しい（または古い）パッケージを要求し、他のすべてのノードと競合する場合があります。そのノードを単独の仮想環境で実行する「互換性レイヤ」を設定することができます。一部の高度なカスタムノードは、インストールスクリプト（install.py）内でこのアプローチを採用しています。

手動で行う場合は、以下のような概念です：

# ノード固有の依存関係をユーザーサイトパッケージディレクトリにインストール
# これは、システム全体やメインの仮想環境を汚染しません。
pip install --target="/path/to/ComfyUI/custom_nodes/ProblematicNode/deps" -r requirements.txt

そして、ノードの__init__.pyファイルを修正し、Pythonのsys.pathにそのdepsディレクトリを追加して、独自の依存関係を優先的に読み込むようにします。

3.5 ステップ5：ComfyUI Managerの「Update All」の慎重な使用

ComfyUI Managerの「Update All」ボタンは便利ですが、依存関係の大規模な変更を引き起こす可能性が高いです。更新を行う際は、以下の手順を推奨します。

1. 重要なワークフローを完了させるか、バックアップを取る。
2. 一度にすべてを更新するのではなく、ノードを数個ずつグループに分けて更新する。
3. 各更新後にComfyUIを再起動し、既存のワークフローが正常に動作するかテストする。
4. 問題が発生した場合は、そのノードのGitHubリリースページやIssuesを確認し、既知の問題や必要な追加手順がないか調べる。

4. コード例・コマンド例：トラブルシューティング実践集

4.1 依存関係ツリーの確認

# pipdeptreeツールをインストールして、依存関係のグラフを可視化
pip install pipdeptree
pipdeptree

# 特定のパッケージ（例：torch）に依存しているものをすべて表示
pipdeptree --reverse --packages torch

4.2 パッケージの強制再インストール（最終手段）

環境が完全に壊れてしまった場合、ComfyUI本体の依存関係からやり直します。

# 仮想環境を有効化した状態で
cd /path/to/ComfyUI

# すべてのパッケージをアンインストール（仮想環境内なので安全）
pip freeze | xargs pip uninstall -y

# ComfyUI本体の必須パッケージを再インストール
pip install -r requirements.txt --force-reinstall

# その後、本当に必要なカスタムノードのみを一つずつ再インストール

4.3 ノードのバージョンを固定する

安定した環境を構築したら、カスタムノードを特定のコミットに固定することで、予期しない更新を防ぎます。これは、カスタムノードのディレクトリ内でGitを使用して行います。

cd /path/to/ComfyUI/custom_nodes/your_custom_node
git checkout [安定しているとわかっているコミットハッシュ]
# 例: git checkout a1b2c3d4e5f67890

5. まとめ・補足情報

ComfyUI Managerによるパッケージ競合は、活発に開発が進むエコシステムでは避けられない課題です。しかし、仮想環境の徹底活用と、計画的で段階的な更新を行うことで、そのリスクを大幅に低減できます。

重要なポイント:

仮想環境は必須: ComfyUIの運用では、システム環境からの分離を第一に考えてください。
更新は計画的に: 「Update All」は控えめに使用し、更新後は必ず動作確認を行います。
バックアップを習慣化: 安定した環境のrequirements.txtは定期的にバックアップし、問題発生時にすぐに復旧できるようにします。
コミュニティを活用: 特定のノードで問題が発生した場合は、そのノードのGitHub IssuesやComfyUIのDiscordコミュニティを確認し、既知の解決策や回避策がないか探します。

依存関係の管理は地味な作業ですが、AI画像生成という創造的な作業を中断させないための重要な基盤です。これらのプラクティスを身につけることで、ComfyUIをよりストレスフリーに、そして生産的に活用できるようになるでしょう。