メインコンテンツへスキップ

​
カスタムノードとは？

カスタムノードは、高度な画像処理、機械学習のファインチューニング、色調整などの新機能を追加する ComfyUI 用の拡張機能です。これらのコミュニティ開発ノードは、ComfyUI のコア機能を大幅に拡張することができます。
カスタムノードをインストールする前に、慎重に確認することが重要です。ComfyUI はオープンソースプロジェクトであるため、悪意のあるプラグインがカスタムノードを悪用する可能性があります：
  1. 信頼できる作者からのものや、コミュニティで一般的に使用されているカスタムノードのみをインストールしてください
  2. インストール前にプラグインの機能を理解し、システムのセキュリティを確保するために不明なソースを避けてください
  3. 不明確なプラグインや疑わしいプラグインのインストールは避けてください - 未検証のプラグインはシステムの侵害につながるセキュリティリスクをもたらす可能性があります
すべてのカスタムノードのインストールには、次の 2 つのステップを完了する必要があります：
  1. ノードコードを ComfyUI/custom_nodes ディレクトリにクローンする
  2. 必要な Python 依存関係をインストールする
このガイドでは 3 つのインストール方法を比較します。ComfyUI Manager は現在のほとんどの ComfyUI リリースに組み込まれています。機能と有効化方法については ComfyUI Manager 概要 をまず参照してください。レジストリにないノードや特定のリビジョンが必要な場合は、Git クローン または ZIP を使用してください。
方法利点欠点
ComfyUI Manager (推奨)1. 自動化されたインストール
2. 依存関係の処理
3. GUI インターフェース		レジストリに登録されていないノードを直接検索できない
Git Cloneレジストリに登録されていないノードをインストールできる1. Git の知識が必要
2. 依存関係の手動処理
3. インストールのリスク
リポジトリ ZIP ダウンロード1. Git 不要
2. 手動制御		1. 依存関係の手動処理
2. バージョン管理なし
3. インストールのリスク
ヒント：カスタムノードをインストールする前に、プラグインの README ファイルを確認して、インストール方法、使用方法、特定のモデル、依存関係のバージョン、一般的な問題の解決策などの要件を理解してください。

​
方法 1: ComfyUI Manager (推奨)

この方法を使用するには、お使いの環境で ComfyUI Manager が利用可能な状態になっている必要があります。表示されていない、または無効になっている場合は、ComfyUI Manager 概要 を確認し、インストールガイド の手順に従ってください。
ComfyUI Manager は、カスタムノードを管理するための 2 つの UI バージョンを提供しています。お使いのインターフェースに合うガイドを選択してください：

新しい UI (Desktop 版デフォルト)

Desktop ユーザー向けにデフォルトで有効になっている新しいノード管理インターフェース。

従来の UI

カスタムノードインストール用のクラシックな Manager インターフェース。

​
方法 2: Git を使用した手動インストール

Manager に見つからない新しいノードや特定のバージョンが必要な場合に適しています。システムに Git がインストールされている必要があります。
1

リポジトリ URL を取得する

GitHub で「Code」ボタンをクリックし、HTTPS リンクをコピーします
2

custom_nodes ディレクトリに移動する

cd /path/to/ComfyUI/custom_nodes
3

リポジトリをクローンする

git clone [リポジトリ URL]
4

依存関係をインストールする

依存関係は ComfyUI 環境にインストールする必要があります - システム環境と混同しないように注意してください。汚染を避けるためです
Windows ポータブル版の場合、依存関係は埋め込み Python 環境にインストールします
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[ノードディレクトリ]\requirements.txt
5

ComfyUI を再起動しブラウザを更新する

ComfyUI を再起動し、ブラウザを更新してください。起動ログに import failed エラーがないか確認します

​
方法 3: ZIP ダウンロードによるインストール

Git や Manager を使用できないユーザー向けです
バージョン管理機能が失われるため、このインストール方法は推奨しません
1

GitHub で `Code` → `Download ZIP` をクリック

GitHub ページで Code → Download ZIP をクリックしますClick Code → Download ZIP on GitHub
2

ZIP ファイルを解凍する

ダウンロードした ZIP ファイルを解凍します
3

解凍したフォルダを `ComfyUI/custom_nodes/` ディレクトリにコピー

解凍したフォルダを ComfyUI/custom_nodes/ ディレクトリにコピーします
4

依存関係を手動でインストールする (Git 方法のステップ 4 と同様)

ComfyUI を再起動し、ブラウザを更新します
5

インストールが成功したことを確認する

再起動後に ComfyUI Manager を確認し、プラグインが正常にインストールされており、import failed エラーがないことを確認します

​
カスタムノードリソース

ComfyUI では、基本的なノード拡張機能に加えて、カスタムノードには以下の追加リソースを含めることができます：
  • ノードドキュメント: この機能はすべてのカスタムノードと基本ノードをサポートしています。ノードドキュメントを表示して、ノードの目的と使用方法を理解することができます。また、作者に PR を送信してドキュメントを貢献することもできます。
  • カスタムノードワークフローテンプレート: ノード作者が提供するサンプルワークフローとしてのワークフローテンプレート。ComfyUI テンプレートから閲覧およびロードできます。
  • 多言語サポート
カスタムノード開発者の場合、これらのリソースを追加して、カスタムノードをよりユーザーフレンドリーにすることができます。