カスタムノードについて
ComfyUI をインストールした後、ComfyUI にはすでに多くのノードが含まれていることに気づくでしょう。これらのネイティブノードは Comfy Core ノードと呼ばれ、ComfyUI 公式によってメンテナンスされています。
さらに、ComfyUI コミュニティのさまざまな作者によって作成された数多くの カスタムノード があります。これらのカスタムノードは ComfyUI に広範な機能をもたらし、その機能と能力の境界を大きく拡張します。
このガイドでは、カスタムノードに関連するさまざまな操作について説明します。インストール、更新、無効化、アンインストール、依存関係のインストールなどを含みます。
誰でも ComfyUI 用の独自のカスタム拡張機能を開発し、他の人と共有することができます。多くのコミュニティカスタムノードを こちら で見つけることができます。独自のカスタムノードを開発したい場合は、以下のセクションを訪れて開始してください：
カスタムノードの開発を開始
カスタムノードの開発を開始する方法を学ぶ
カスタムノード管理
このセクションでは以下について説明します：
- カスタムノードのインストール
- ノード依存関係のインストール
- カスタムノードのバージョン管理
- カスタムノードのアンインストール
- カスタムノードの一時的な無効化
- カスタムノードの依存関係の競合の処理
1. カスタムノードのインストール
現在、ComfyUI は複数の方法でカスタムノードをインストールすることをサポートしています。以下を含みます：
カスタムノードは ComfyUI Manager 経由でインストールすることを推奨します。これは ComfyUI カスタムノードエコシステムにおいて非常に重要なツールです。カスタムノード管理（検索、インストール、更新、無効化、アンインストールなど）を簡単にします。ComfyUI Manager でインストールしたいノードを検索し、インストールをクリックするだけです。
ただし、現在すべてのカスタムノードは GitHub に保存されているため、GitHub に正常にアクセスできない地域向けに、このガイドでは異なるカスタムノードインストール方法の詳細な手順を記載しています。
さらに、プラグイン管理には ComfyUI Manager の使用を推奨しているため、このツールを使用してプラグインを管理することを推奨します。ソースコードは こちら で見つけることができます。
したがって、このドキュメントでは、カスタムノードインストールの例として ComfyUI Manager のインストールを使用し、関連する紹介セクションでノード管理に如何使用するかを補足します。
ComfyUI Manager は非常に豊富な機能を持っているため、ComfyUI Manager のインストール章は別のドキュメントで紹介します。以下のリンクを訪れて、ComfyUI Manager を使用してカスタムノードをインストールする方法を学んでください。ComfyUI Manager でカスタムノードをインストール
ComfyUI Manager を使用してカスタムノードをインストールする方法を学ぶ
Git がインストールされていることを確認
まず、システムに Git がインストールされていることを確認する必要があります。システムターミナルで以下のコマンドを入力して、Git がインストールされているか確認できます：Git がインストールされている場合、以下のような出力が表示されます：
まだインストールされていない場合は、git-scm.com を訪れて対応するインストールパッケージをダウンロードしてください。Linux ユーザーは git-scm.com/downloads/linux を参照してインストール手順を確認してください。ComfyUI Desktop バージョンの場合、以下のように Desktop ターミナルを使用してインストールを完了できます。
カスタムノードコードをディレクトリにクローン
Git のインストールを完了した後、カスタムノードのリポジトリアドレスが必要です。ここでは ComfyUI-Manager リポジトリアドレスを例として使用します：https://github.com/Comfy-Org/ComfyUI-Manager
GitHub にスムーズにアクセスできない地域の場合、他のコードホスティングサービスウェブサイトを使用して対応するリポジトリをフォークし、そのリポジトリアドレスを使用してノードインストールを完了できます。gitee などがあります。
D:\ComfyUI_windows_portable の場合、D:\ComfyUI_windows_portable\ComfyUI\custom_nodes にカスタムノードフォルダが見つかるはずです。まず、cd コマンドを使用して対応するディレクトリに入ります：cd D:\ComfyUI_windows_portable\ComfyUI\custom_nodes
git clone コマンドを使用してノードインストールを完了します：git clone https://github.com/Comfy-Org/ComfyUI-Manager
これは、カスタムノードコードを正常にクローンしたことを意味します。次に、対応する依存関係をインストールする必要があります。 手動インストールは推奨されるインストール方法ではありませんが、git を使用してスムーズにインストールできない場合のバックアップオプションとして機能します。この方法でインストールされたプラグインは、対応する git バージョン履歴情報を失い、後続のバージョン管理が不便になります。
カスタムノードコード ZIP パッケージをダウンロード
手動インストールの場合、まず対応するノードコードをダウンロードし、適切なディレクトリに解凍する必要があります。
対応するカスタムノードリポジトリページを訪れます：
Code ボタンをクリック- 次に
Download ZIP ボタンをクリックして ZIP パッケージをダウンロード
- ZIP パッケージを解凍
ファイルを ComfyUI カスタムノードディレクトリにコピー
上記の手順で解凍したコードを ComfyUI カスタムノードディレクトリにコピーします。ComfyUI ポータブルバージョンを例として、フォルダの場所が D:\ComfyUI_windows_portable の場合、D:\ComfyUI_windows_portable\ComfyUI\custom_nodes にカスタムノードフォルダが見つかるはずです。上記の手順で解凍したコードを対応するディレクトリにコピーします。
2. ノード依存関係のインストール
カスタムノードはすべて関連する依存関係のインストールが必要です。例えば、ComfyUI-Manager の場合、requirements.txt ファイルを訪れて依存パッケージの要件を確認できます。
前の手順では、カスタムノードコードをローカルにクローンしただけで、対応する依存関係をインストールしていませんでした。したがって、次に対応する依存関係をインストールする必要があります。
実際、ComfyUI-Manager を使用してプラグインをインストールする場合、ComfyUI Manager は自動的に依存関係のインストールを完了してくれます。プラグインをインストールした後、ComfyUI を再起動するだけです。これが、カスタムノードをインストールするために ComfyUI Manager の使用を強く推奨する理由です。ただし、状況によっては ComfyUI Manager を使用してカスタムノードをスムーズにインストールできない場合もあるため、このより詳細な依存関係インストールガイドを提供しています。
pip install -r requirements.txt を実行すると、対応する依存関係がシステムレベルの Python 環境にインストールされる可能性があり、ComfyUI の環境で依存関係が仍然として欠落し、対応するカスタムノードが正常に実行できなくなります。
したがって、次に ComfyUI の独立した Python ランタイム環境を使用して依存関係のインストールを完了する必要があります。
異なる ComfyUI バージョンに応じて、対応する依存関係をインストールするために異なる方法を使用します：
ComfyUI Portable
ComfyUI Desktop
カスタム Python 環境ユーザー
ComfyUI Portable バージョンの場合、\ComfyUI_windows_portable\python_embeded ディレクトリにある埋め込み Python を使用します。この Python を使用して依存関係のインストールを完了する必要があります。まず、ポータブルバージョンディレクトリでターミナルを起動するか、ターミナルを起動した後 cd コマンドを使用して \ComfyUI_windows_portable\ ディレクトリに移動します。
ターミナルディレクトリが \ComfyUI_windows_portable\ であることを確認します。以下は D:\ComfyUI_windows_portable\ の例です。
次に、python_embeded\python.exe を使用して依存関係のインストールを完了します：python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
requirements.txt ファイルが存在することを確認してください。 ComfyUI Desktop はインストールプロセス中にすでに ComfyUI-Manager とその依存関係がインストールされているため、このガイドはカスタムノードインストールの例として ComfyUI Manager を使用していますが、実際にはデスクトップバージョンで ComfyUI Manager の依存関係インストールを実行する必要はありません。
予期しない問題がない限り、カスタムノードをインストールするために ComfyUI Manager の使用を推奨します。そうすれば、依存関係を手動でインストールする必要はありません。
pip install -r .\custom_nodes\<corresponding_custom_node_name>\requirements.txt
カスタム Python 環境を持つユーザーの場合、pip install -r requirements.txt を使用して依存関係のインストールを完了することを推奨します。
カスタムノードバージョン管理
カスタムノードのバージョン管理は実際には Git バージョン管理に基づいています。Git を通じてノードバージョンを管理できますが、ComfyUI Manager はすでにこのバージョン管理機能を非常によく統合しています。@Dr.Lt.Data さんに、このような便利なツールをもたらしてくれたことに感謝します。
このセクションでは、これら 2 つの異なるプラグインバージョン管理方法について説明しますが、ZIP パッケージを使用して手動でインストールする場合、対応する git バージョン履歴情報が失われ、バージョン管理を実行できなくなります。
ComfyUI Manager を反復しているため、実際の最新のインターフェースと手順は大幅に変更される可能性があります
ノード管理インターフェースに入る
図に示すように対応する操作を実行して、ComfyUI Manager インターフェースに入ります
対応するカスタムノードパッケージを見つける
対応するフィルターを使用してインストールされたノードパッケージをフィルタリングし、対応するノード管理を実行できます
バージョン切り替えを実行
対応するバージョンに切り替えます。Manager は対応する依存関係の更新とインストールを完了してくれます。通常、バージョンを切り替えた後、変更を有効にするために ComfyUI を再起動する必要があります。
コマンドラインを使用してディレクトリに移動
対応するノードが位置するディレクトリフォルダーを見つけます。例：ComfyUI/custom_nodes/ComfyUI-Manager
cd コマンドを使用して対応するフォルダーに入ります：cd <your_installation_directory>/ComfyUI/custom_nodes/ComfyUI-Manager
Git コマンドを使用してバージョンを表示
以下のコマンドを使用して、利用可能なすべてのタグとリリースを表示できます：これにより、すべてのバージョンタグが一覧表示され、切り替えたいバージョンを選択できます。 指定されたバージョンに切り替え
以下のコマンドを使用して、指定されたタグまたはリリースに切り替えます：<tag_name> を切り替えたい特定のバージョンタグに置き換えます。 特定のコミットバージョンに切り替え
特定のコミットバージョンに切り替えたい場合、以下のコマンドを使用できます：git checkout <commit_hash>
<commit_hash> を切り替えたい特定のコミットハッシュに置き換えます。 依存関係をインストール
バージョン切り替え後、対応するカスタムノードパッケージの依存関係が変更される可能性があるため、対応するノードの依存関係を再インストールする必要があります。ノード依存関係のインストール セクションの説明を参照して、対応する環境に入りインストールしてください。 カスタムノードのアンインストール
更新予定
カスタムノードの一時的な無効化
更新予定
カスタムノードの依存関係の競合
更新予定
ComfyUI Manager
このツールは現在 Desktop バージョン にデフォルトで含まれており、Portable バージョン では、このドキュメントの Manager のインストール セクションのインストール手順を参照する必要があります。
ComfyUI の開発に伴い、ComfyUI Manager は ComfyUI においてますます重要な役割を果たしています。現在、ComfyUI-Manager は正式に Comfy Org 組織に参加し、ComfyUI のコア依存関係の一部となり、元の作者 Dr.Lt.Data によって引き続きメンテナンスされています。詳細については このブログ投稿 を読むことができます。
将来の反復では、ComfyUI Manager の使用を大幅に最適化するため、このドキュメントに表示されるインターフェースは最新バージョンの ComfyUI Manager と異なる可能性があります。 Manager のインストール
ComfyUI サーバーアプリケーションを実行している場合、manager をインストールする必要があります。ComfyUI が実行されている場合は、続行する前に閉じてください。
最初のステップは Git のインストールです。これはソフトウェアバージョン管理のためのコマンドラインアプリケーションです。Git は github.com から ComfyUI manager をダウンロードします。git-scm.com から Git をダウンロードしてインストールします。
Git をインストールした後、ComfyUI サーバープログラムディレクトリに移動し、custom_nodes とラベル付けされたフォルダーに入ります。コマンドウィンドウまたはターミナルを開きます。コマンドラインが現在のディレクトリパスを custom_nodes として表示していることを確認します。以下のコマンドを入力します。これにより manager がダウンロードされます。技術的には、これは Git リポジトリのクローン と呼ばれます。
欠落ノードの検出
manager をインストールした後、manager で欠落ノードを検出できます。
カスタムノードの開発
ある程度の開発能力をお持ちの場合は、以下のドキュメントから開始して、カスタムノードの開発を開始する方法を学んでください。
カスタムノードの開発を開始
カスタムノードの開発を開始する方法を学ぶ
