> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI でのカスタムノードのインストール方法

> このガイドでは、ComfyUI にカスタムノードをインストールするさまざまな方法について説明します

## カスタムノードとは？

カスタムノードは、高度な画像処理、機械学習のファインチューニング、色調整などの新機能を追加する ComfyUI 用の拡張機能です。これらのコミュニティ開発ノードは、ComfyUI のコア機能を大幅に拡張することができます。

<Warning>
  カスタムノードをインストールする前に、慎重に確認することが重要です。ComfyUI はオープンソースプロジェクトであるため、悪意のあるプラグインがカスタムノードを悪用する可能性があります：

  1. 信頼できる作者からのものや、コミュニティで一般的に使用されているカスタムノードのみをインストールしてください
  2. インストール前にプラグインの機能を理解し、システムのセキュリティを確保するために不明なソースを避けてください
  3. 不明確なプラグインや疑わしいプラグインのインストールは避けてください - 未検証のプラグインはシステムの侵害につながるセキュリティリスクをもたらす可能性があります
</Warning>

すべてのカスタムノードのインストールには、次の 2 つのステップを完了する必要があります：

1. ノードコードを `ComfyUI/custom_nodes` ディレクトリにクローンする
2. 必要な Python 依存関係をインストールする

このガイドでは 3 つのインストール方法を比較します。**ComfyUI Manager** は現在のほとんどの ComfyUI リリースに組み込まれています。機能と有効化方法については [ComfyUI Manager 概要](/ja/manager/overview) をまず参照してください。レジストリにないノードや特定のリビジョンが必要な場合は、**Git クローン** または **ZIP** を使用してください。

| 方法                       | 利点                                                   | 欠点                                                 |
| ------------------------ | ---------------------------------------------------- | -------------------------------------------------- |
| **ComfyUI Manager** (推奨) | 1. 自動化されたインストール<br />2. 依存関係の処理<br />3. GUI インターフェース | レジストリに登録されていないノードを直接検索できない                         |
| **Git Clone**            | レジストリに登録されていないノードをインストールできる                          | 1. Git の知識が必要<br />2. 依存関係の手動処理<br />3. インストールのリスク |
| **リポジトリ ZIP ダウンロード**     | 1. Git 不要<br />2. 手動制御                               | 1. 依存関係の手動処理<br />2. バージョン管理なし<br />3. インストールのリスク  |

ヒント：カスタムノードをインストールする前に、プラグインの README ファイルを確認して、インストール方法、使用方法、特定のモデル、依存関係のバージョン、一般的な問題の解決策などの要件を理解してください。

## 方法 1: ComfyUI Manager (推奨)

<Note>
  この方法を使用するには、お使いの環境で ComfyUI Manager が利用可能な状態になっている必要があります。表示されていない、または無効になっている場合は、[ComfyUI Manager 概要](/ja/manager/overview) を確認し、[インストールガイド](/ja/manager/install) の手順に従ってください。
</Note>

ComfyUI Manager は、カスタムノードを管理するための 2 つの UI バージョンを提供しています。お使いのインターフェースに合うガイドを選択してください：

<Columns cols={2}>
  <Card title="新しい UI (Desktop 版デフォルト)" icon="sparkles" href="/ja/manager/pack-management">
    Desktop ユーザー向けにデフォルトで有効になっている新しいノード管理インターフェース。
  </Card>

  <Card title="従来の UI" icon="rectangle-history" href="/ja/manager/legacy-ui">
    カスタムノードインストール用のクラシックな Manager インターフェース。
  </Card>
</Columns>

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

Manager に見つからない新しいノードや特定のバージョンが必要な場合に適しています。システムに [Git](https://git-scm.com/) がインストールされている必要があります。

<Steps>
  <Step title="リポジトリ URL を取得する">
    GitHub で「Code」ボタンをクリックし、HTTPS リンクをコピーします
  </Step>

  <Step title="custom_nodes ディレクトリに移動する">
    ```bash theme={null}
    cd /path/to/ComfyUI/custom_nodes
    ```
  </Step>

  <Step title="リポジトリをクローンする">
    ```bash theme={null}
    git clone [リポジトリ URL]
    ```
  </Step>

  <Step title="依存関係をインストールする">
    依存関係は ComfyUI 環境にインストールする必要があります - システム環境と混同しないように注意してください。汚染を避けるためです

    <Tabs>
      <Tab title="Windows ポータブル版">
        Windows ポータブル版の場合、依存関係は埋め込み Python 環境にインストールします

        ```bash theme={null}
        python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[ノードディレクトリ]\requirements.txt
        ```
      </Tab>

      <Tab title="手動インストール">
        ComfyUI 環境に依存関係をインストールします

        ```bash theme={null}
        cd [ノードディレクトリ]
        pip install -r requirements.txt
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="ComfyUI を再起動しブラウザを更新する">
    ComfyUI を再起動し、ブラウザを更新してください。起動ログに `import failed` エラーがないか確認します
  </Step>
</Steps>

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

Git や Manager を使用できないユーザー向けです

<Warning>
  バージョン管理機能が失われるため、このインストール方法は推奨しません
</Warning>

<Steps>
  <Step title="GitHub で `Code` → `Download ZIP` をクリック">
    GitHub ページで `Code` → `Download ZIP` をクリックします

    <img src="https://mintcdn.com/dripart-docs-recommend-assets-api/g5cr9KIJXlIfM-V4/images/installation/custom_nodes/install-custom-nodes-by-zip.jpg?fit=max&auto=format&n=g5cr9KIJXlIfM-V4&q=85&s=e55e92dfe95af6e05cbd2a1f4d7ac07f" alt="Click Code → Download ZIP on GitHub" width="2000" height="1115" data-path="images/installation/custom_nodes/install-custom-nodes-by-zip.jpg" />
  </Step>

  <Step title="ZIP ファイルを解凍する">
    ダウンロードした ZIP ファイルを解凍します
  </Step>

  <Step title="解凍したフォルダを `ComfyUI/custom_nodes/` ディレクトリにコピー">
    解凍したフォルダを `ComfyUI/custom_nodes/` ディレクトリにコピーします
  </Step>

  <Step title="依存関係を手動でインストールする (Git 方法のステップ 4 と同様)">
    ComfyUI を再起動し、ブラウザを更新します
  </Step>

  <Step title="インストールが成功したことを確認する">
    再起動後に ComfyUI Manager を確認し、プラグインが正常にインストールされており、`import failed` エラーがないことを確認します
  </Step>
</Steps>

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

ComfyUI では、基本的なノード拡張機能に加えて、カスタムノードには以下の追加リソースを含めることができます：

* [ノードドキュメント](/custom-nodes/help_page): この機能はすべてのカスタムノードと基本ノードをサポートしています。ノードドキュメントを表示して、ノードの目的と使用方法を理解することができます。また、作者に PR を送信してドキュメントを貢献することもできます。
* [カスタムノードワークフローテンプレート](/custom-nodes/workflow_templates): ノード作者が提供するサンプルワークフローとしてのワークフローテンプレート。ComfyUI テンプレートから閲覧およびロードできます。
* [多言語サポート](/custom-nodes/i18n)

カスタムノード開発者の場合、これらのリソースを追加して、カスタムノードをよりユーザーフレンドリーにすることができます。