> ## 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 のインストールは、主に以下のいくつかのステップに分かれます：

1. 仮想環境を作成する（システムレベルの Python 環境を汚染しないため）
2. ComfyUI コードリポジトリをクローンする
3. 依存関係をインストールする
4. ComfyUI を起動する

ComfyUI のインストールには、[ComfyUI CLI](/comfy-cli/getting-started) を参照することもできます。これは、ComfyUI を簡単にインストールし、その依存関係を管理できるコマンドラインツールです。

## 仮想環境の作成

<Tip>
  独立した仮想環境は必要です。ComfyUI の依存関係がシステム上の他の依存関係と競合する可能性があり、システムレベルの Python 環境を汚染することも避けることができるためです。
</Tip>

[Miniconda のインストール](https://docs.anaconda.com/free/miniconda/index.html#latest-miniconda-installer-links)。これにより、ComfyUI で必要となる適切なバージョンの Python およびその他のライブラリをインストールできます。

Conda を使用して環境を作成します。

```
conda create -n comfyenv
conda activate comfyenv
```

## ComfyUI コードリポジトリのクローン

システムに [Git](https://git-scm.com/downloads) がインストールされていることを確認する必要があります。まず、ターミナル（コマンドライン）を開き、次にコードリポジトリをクローンします。

<Tabs>
  <Tab title="Windows">
    <Warning>Microsoft Visual C++ Redistributable をインストールしていない場合は、[こちら](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) からインストールしてください。</Warning>
  </Tab>

  <Tab title="Linux">
    ターミナルアプリケーションを開きます。
  </Tab>

  <Tab title="MacOS">
    [ターミナルアプリケーション](https://support.apple.com/guide/terminal/open-or-quit-terminal-apd5265185d-f365-44cb-8b09-71a064a42125/mac) を開きます。
  </Tab>
</Tabs>

```bash theme={null}
git clone git@github.com:comfyanonymous/ComfyUI.git
```

## GPU および ComfyUI 依存関係のインストール

<Steps>
  <Step title="GPU 依存関係のインストール">
    GPU 依存関係のインストール

    <Accordion title="Nvidia">
      ```
      conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia
      ```

      Alternatively, you can install the nightly version of PyTorch.

      <Accordion title="Install Nightly">
        <Warning>Install Nightly version (might be more risky)</Warning>

        ```
        conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch-nightly -c nvidia
        ```
      </Accordion>
    </Accordion>

    <Accordion title="AMD">
      ```
      pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0
      ```

      Alternatively, you can install the nightly version of PyTorch.

      <Accordion title="Install Nightly">
        <Warning>Install Nightly version (might be more risky)</Warning>

        ```
        pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.0
        ```
      </Accordion>
    </Accordion>

    <Accordion title="Mac ARM Silicon">
      ```bash theme={null}
      conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly
      ```
    </Accordion>
  </Step>

  <Step title="ComfyUI 依存関係のインストール">
    ```bash theme={null}
    cd ComfyUI
    pip install -r requirements.txt
    ```
  </Step>

  <Step title="ComfyUI の起動">
    アプリケーションを起動する

    ```
    cd ComfyUI
    python main.py
    ```
  </Step>
</Steps>

## ComfyUI の更新方法

<Steps>
  <Step title="最新コードの取得">
    コマンドラインを使用して ComfyUI のインストールパスに入り、最新コードを取得します。

    ```bash theme={null}
    cd <installation path>/ComfyUI
    git pull
    ```
  </Step>

  <Step title="依存関係のインストール">
    コマンドラインを使用して ComfyUI のインストールパスに入り、依存関係をインストールします。

    <Warning>
      現在の Python 環境が ComfyUI の仮想環境であることを確認する必要があります。そうでない場合、依存関係がシステムレベルの Python 環境にインストールされ、システムレベルの Python 環境を汚染してしまいます。
    </Warning>

    ```bash theme={null}
        pip install -r requirements.txt
    ```
  </Step>
</Steps>

## 外部モデルパスの追加

`ComfyUI/models` ディレクトリの外部でモデルファイルを管理したい場合、以下のような理由が考えられます。

* 複数の ComfyUI インスタンスを運用しており、ディスク容量の節約のためにモデルファイルを共有したい
* WebUI などの異なる種類の GUI アプリケーションを併用しており、それらで共通のモデルファイルを使いたい
* モデルファイルが認識されない、または見つからない

このため、`extra_model_paths.yaml` 設定ファイルを用いて、追加のモデル検索パスを指定する方法を提供しています。

### 設定ファイルの開き方

<Tabs>
  <Tab title="ポータブル版／手動インストール版">
    [ポータブル版](/installation/comfyui_portable_windows) や [手動インストール版](/installation/manual_install) の ComfyUI の場合、ComfyUI のルートディレクトリに `extra_model_paths.yaml.example` という名前のサンプルファイルが含まれています。

    ```
    ComfyUI/extra_model_paths.yaml.example
    ```

    このファイルをコピーし、名前を `extra_model_paths.yaml` に変更して使用します。ファイルは必ず ComfyUI のルートディレクトリ（`ComfyUI/extra_model_paths.yaml`）に保存してください。\
    また、このサンプル設定ファイルは [こちら](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) からも参照できます。
  </Tab>

  <Tab title="ComfyUI Desktop">
    [ComfyUI Desktop](/installation/desktop/windows) アプリケーションをご利用の場合、以下の画像を参考に、追加モデル設定ファイルを開くことができます：

    <img src="https://mintcdn.com/dripart-docs-recommend-assets-api/xaP6njr8GCp0UjLg/images/desktop/extra_model_paths.png?fit=max&auto=format&n=xaP6njr8GCp0UjLg&q=85&s=ddd9f3d45170457ead8164650a6c64b5" alt="Open Config File" width="2004" height="1442" data-path="images/desktop/extra_model_paths.png" />

    または、直接以下のパスから開くことも可能です：

    <Tabs>
      <Tab title="Windows">
        ```
        C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml
        ```
      </Tab>

      <Tab title="macOS">
        ```
        ~/Library/Application Support/ComfyUI/extra_models_config.yaml
        ```
      </Tab>
    </Tabs>

    この設定ファイルは、上記の場所に常に保存しておく必要があります。他の場所へ移動しないでください。
  </Tab>
</Tabs>

該当ファイルが存在しない場合は、任意のテキストエディタで新規作成してください。

### 設定例

たとえば、以下の構造でモデルファイルを格納している場合：

```
📁 YOUR_PATH/
  ├── 📁models/
  |   ├── 📁 loras/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 checkpoints/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 vae/
  |   │   └── xxxxx.safetensors
  |   └── 📁 controlnet/
  |       └── xxxxx.safetensors
```

このパスを ComfyUI が認識できるよう、`extra_model_paths.yaml` を次のように設定できます：

```
my_custom_config:
    base_path: YOUR_PATH
    loras: models/loras/
    checkpoints: models/checkpoints/
    vae: models/vae/
    controlnet: models/controlnet/
```

あるいは以下のようにも設定可能です：

```
my_custom_config:
    base_path: YOUR_PATH/models/
    loras: loras
    checkpoints: checkpoints
    vae: vae
    controlnet: controlnet
```

<Warning>
  デスクトップ版では、インストール時に自動生成されたパス設定を上書きせず、既存の設定ファイルに新しい設定を追加してください。誤った編集を行った場合に備えて、変更前に該当ファイルのバックアップを必ず取得してください。
</Warning>

そのほかの設定オプションについては、デフォルトの [extra\_model\_paths.yaml.example](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) をご参照ください。設定を保存した後は、**ComfyUI を再起動**する必要があります。

以下は、元の設定ファイルのサンプルです：

```yaml theme={null}
# このファイルを extra_model_paths.yaml に名前を変更すると、ComfyUI が読み込みます


# a1111 UI 向け設定
# 必要なのは、base_path をご自身のインストール先に変更することだけです
a111:
    base_path: path/to/stable-diffusion-webui/

    checkpoints: models/Stable-diffusion
    configs: models/Stable-diffusion
    vae: models/VAE
    loras: |
         models/Lora
         models/LyCORIS
    upscale_models: |
                  models/ESRGAN
                  models/RealESRGAN
                  models/SwinIR
    embeddings: embeddings
    hypernetworks: models/hypernetworks
    controlnet: models/ControlNet

# ComfyUI 向け設定
# base_path には、既存の ComfyUI インストール先、またはすべてのモデル・LoRA などを一元管理する中央フォルダのパスを指定してください

#comfyui:
#     base_path: path/to/comfyui/
#     # is_default を true に設定すると、これらのフォルダが優先的にリスト表示され、ダウンロード先などデフォルトのディレクトリとして使用されます
#     #is_default: true
#     checkpoints: models/checkpoints/
#     clip: models/clip/
#     clip_vision: models/clip_vision/
#     configs: models/configs/
#     controlnet: models/controlnet/
#     diffusion_models: |
#                  models/diffusion_models
#                  models/unet
#     embeddings: models/embeddings/
#     loras: models/loras/
#     upscale_models: models/upscale_models/
#     vae: models/vae/

# その他の UI 向け設定
#other_ui:
#    base_path: path/to/ui
#    checkpoints: models/checkpoints
#    gligen: models/gligen
#    custom_nodes: path/custom_nodes

```

たとえば、WebUI が `D:\stable-diffusion-webui\` にインストールされている場合、対応する設定を次のように変更できます：

```yaml theme={null}
a111:
    base_path: D:\stable-diffusion-webui\
    checkpoints: models/Stable-diffusion
    configs: models/Stable-diffusion
    vae: models/VAE
    loras: |
         models/Lora
         models/LyCORIS
    upscale_models: |
                  models/ESRGAN
                  models/RealESRGAN
                  models/SwinIR
    embeddings: embeddings
    hypernetworks: models/hypernetworks
    controlnet: models/ControlNet
```

### 追加のカスタムノードパスの登録

外部モデルの追加に加え、ComfyUI のデフォルトパスに含まれていないカスタムノードのパスも登録できます。

<Tip>
  この設定は、カスタムノードのデフォルトインストールパスを変更するものではありません。ComfyUI 起動時に追加の検索パスとして認識されるようになります。ただし、実行環境の完全性を保つため、対応する環境においてカスタムノードの依存関係を引き続き正しくインストールする必要があります。
</Tip>

以下は、macOS 向けの簡単な設定例です。実際の環境に合わせて適宜修正し、対応する設定ファイルに追加してください。変更後は、**ComfyUI を再起動**することで設定が有効になります：

```yaml theme={null}
my_custom_nodes:
  custom_nodes: /Users/your_username/Documents/extra_custom_nodes
```
