Windows デスクトップ版

この記事では、Windows 用 ComfyUI Desktop のダウンロード、インストール、使用方法について紹介します

ComfyUI Desktop は、通常のソフトウェアのようにインストールできるスタンドアロン版です。Python 環境および依存関係のクイックインストールと自動設定をサポートし、既存の ComfyUI 設定、モデル、ワークフロー、ファイルのワンクリックインポートにも対応しています。既存の ComfyUI ポータブル版 からデスクトップ版へ迅速に移行することも可能です。

ComfyUI Desktop はオープンソースプロジェクトです。完全なコードは こちら からご覧ください。

ComfyUI Desktop のハードウェア要件：

• NVIDIA 製 GPU

このチュートリアルでは、ソフトウェアのインストールプロセスをガイドし、関連する設定の詳細について説明します。

ComfyUI Desktop は現在 ベータ版 であるため、実際のインストールプロセスは変更される可能性があります

​

ComfyUI Desktop (Windows) ダウンロード

以下のボタンをクリックして、Windows 用 ComfyUI Desktop のインストールパッケージをダウンロードしてください。

Windows 用ダウンロード (NVIDIA)

​

ComfyUI Desktop インストール手順

ダウンロードしたインストールパッケージファイルをダブルクリックすると、自動インストールが実行され、デスクトップに ComfyUI Desktop のショートカットが作成されます。

対応するショートカットをダブルクリックして、ComfyUI 初期化設定画面に入ります。

​

ComfyUI Desktop 初期化プロセス

1. 起動画面

   通常の起動

   Get Started をクリックして初期化を開始します

   メンテナンスページ

   There are many reasons you might have issues installing ComfyUI. Maybe a network connection failed when installing pytorch (15 GB). Or you don’t have git installed. The maintenance page automatically opens when it detects an issue and provides a way to resolve the issue.

   You can use it to resolve most issues:

   • Python 仮想環境を作成する
   • デスクトップが管理する Python 仮想環境に、不足しているすべてのコア依存関係を再インストールする
   • git および VC Redist をインストールする
   • 新しいインストール先を選択する

   デフォルトのメンテナンスページでは、現在発生しているエラー内容が表示されます。

   

   All をクリックすると、現在操作可能なすべてのコンテンツを表示できます。

   
2. GPU の選択

   

   3 つのオプションがあります：

   1. Nvidia GPU (推奨): pytorch および CUDA を直接サポート
   2. Manual Configuration: Python ランタイム環境を手動でインストールおよび設定する必要があります。設定方法を知っている場合以外は選択しないでください
   3. Enable CPU Mode: 開発者および特殊なケース専用です。必要であることが確実な場合以外は選択しないでください

   特別な事情がない限り、図のように NVIDIA を選択し、Next をクリックして進んでください

3. インストール場所

   

   このステップでは、以下の ComfyUI コンテンツのインストール場所を選択します：

   • Python 環境
   • Models モデルファイル
   • Custom Nodes カスタムノード

   推奨事項：

   • インストール場所として SSD を選択してください。これにより、モデルへのアクセス時の ComfyUI パフォーマンスが向上します。
   • ComfyUI インストールディレクトリとして、別の空のフォルダを作成してください
   • ComfyUI Desktop のインストールを確保するために、対応するディスクに少なくとも 15GB 程度のディスク容量があることを確認してください

   すべてのファイルがこのディレクトリにインストールされるわけではありません。一部のファイルは C ドライブにインストールされたままになります。後でアンインストールする必要がある場合は、このガイドのアンインストールセクションを参照して、ComfyUI Desktop の完全なアンインストールを完了できます

   このステップを完了したら、Next をクリックして次のステップに進みます

4. 既存のインストールから移行 (オプション)

   

   このステップでは、既存の ComfyUI インストール内容を ComfyUI Desktop に移行できます。図のように、元の D:\ComfyUI_windows_portable\ComfyUI インストールディレクトリを選択しました。インストーラーは自動的に以下を認識します：

   • ユーザーファイル
   • Models: コピーされず、デスクトップ版とリンクされるだけです
   • Custom Nodes: ノードは再インストールされます

   心配しないでください。このステップではモデルファイルはコピーされません。必要に応じてオプションをチェックまたはチェック解除できます。Next をクリックして続行します

5. デスクトップ設定

   

   これらは設定項目です：

   1. Automatic Updates: ComfyUI の更新が利用可能な場合に自動更新を設定するかどうか
   2. Usage Metrics: 有効にすると、ComfyUI の改善に役立てるために匿名の利用状況データを収集します
   3. Mirror Settings: プログラムは Python をダウンロードして環境インストールを完了するためにインターネットアクセスが必要です。インストール中に赤い❌が表示され、これがインストール失敗の原因となる可能性がある場合は、以下の手順に従ってください

   

   ミラー設定を展開して、具体的に失敗しているミラーを見つけます。このスクリーンショットでは、エラーは Python Install Mirror の失敗です。

   異なるミラーに関するエラーが発生した場合、以下の内容を参考に、手動で異なるミラーを検索し、置き換えることができます。

   以下は主に中国国内のユーザー向けの内容です。

   ​

   Python インストール用ミラー

   デフォルトのミラーが利用できない場合は、以下のミラーをお試しください。

   https://python-standalone.org/mirror/astral-sh/python-build-standalone
   

   その他の代替 GitHub ミラー URL を探す必要がある場合は、python-build-standalone リポジトリのリリース（releases）を指すミラー URL を検索・構築してください。

   https://github.com/astral-sh/python-build-standalone/releases/download
   

   次の形式でリンクを構築します。

   https://xxx/astral-sh/python-build-standalone/releases/download
   

   ​

   PyPI ミラー

   • アリババクラウド：https://mirrors.aliyun.com/pypi/simple/
   • テンセントクラウド：https://mirrors.cloud.tencent.com/pypi/simple/
   • 中国科学技術大学：https://pypi.mirrors.ustc.edu.cn/simple/
   • 上海交通大学：https://pypi.sjtu.edu.cn/simple/

   ​

   Torch ミラー

   • アリババクラウド：https://mirrors.aliyun.com/pytorch-wheels/cu121/
6. インストールの完了

   すべて正しければ、インストーラーは完了し、自動的に ComfyUI Desktop インターフェースに入ります。これでインストール成功です

   

​

重要：/resource/ComfyUI フォルダーを変更しないでください

/resource/ComfyUI フォルダー内にコンテンツを追加したり、変更したりしないでください。このフォルダー内のすべてのコンテンツは、ComfyUI Desktop の更新時にリセットされます。

他の ComfyUI バージョンとは異なり、Desktop 版ではこのフォルダーが自動的に管理されます。インストール時に、モデル、カスタムノード、その他のユーザー用ファイルの保存先としてカスタムパスを選択しましたので、そちらの場所をご利用ください。

​

最初の画像生成

インストールが完了したら、以下のセクションを参照して、ComfyUI を使い始めてください。

最初の画像生成

このチュートリアルでは、初めてのモデルのインストールおよびテキストから画像を生成する手順を案内します

​

ComfyUI デスクトップ版の更新方法

現在、ComfyUI デスクトップ版の更新は自動検出による更新を採用しています。設定で自動更新が有効になっていることをご確認ください。

また、手動で利用可能な更新を確認することもできます。メニュー → ヘルプ → 更新を確認 を選択してください。

​

外部モデルパスの追加

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

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

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

​

設定ファイルの開き方

ポータブル版／手動インストール版

ポータブル版 や 手動インストール版 の ComfyUI の場合、ComfyUI のルートディレクトリに extra_model_paths.yaml.example という名前のサンプルファイルが含まれています。

ComfyUI/extra_model_paths.yaml.example

このファイルをコピーし、名前を extra_model_paths.yaml に変更して使用します。ファイルは必ず ComfyUI のルートディレクトリ（ComfyUI/extra_model_paths.yaml）に保存してください。
また、このサンプル設定ファイルは こちら からも参照できます。

ComfyUI Desktop

ComfyUI Desktop アプリケーションをご利用の場合、以下の画像を参考に、追加モデル設定ファイルを開くことができます：

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

Windows

C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml

macOS

~/Library/Application Support/ComfyUI/extra_models_config.yaml

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

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

​

設定例

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

📁 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

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

そのほかの設定オプションについては、デフォルトの extra_model_paths.yaml.example をご参照ください。設定を保存した後は、ComfyUI を再起動する必要があります。

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

# このファイルを 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\ にインストールされている場合、対応する設定を次のように変更できます：

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 のデフォルトパスに含まれていないカスタムノードのパスも登録できます。

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

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

my_custom_nodes:
  custom_nodes: /Users/your_username/Documents/extra_custom_nodes

​

デスクトップ版 Python 環境

デスクトップ版のインストールでは、選択したインストール先ディレクトリ内に Python の仮想環境（virtual environment）が作成されます。通常は隠しフォルダである .venv という名前のフォルダになります。

ComfyUI プラグイン向けの依存関係を管理する必要がある場合、この仮想環境内で操作を行う必要があります。システムのコマンドラインを直接使用すると、誤って依存パッケージがシステム環境にインストールされてしまう可能性があるため、以下の手順に従って適切な仮想環境を有効化してください。

​

デスクトップ版 Python 環境の使い方

Desktop（推奨）

デスクトップアプリに内蔵されたターミナルを使用して、Python 環境にアクセスできます。

1. メニューバーのアイコンをクリックして、下部パネルを開きます
2. Terminal をクリックしてターミナルを起動します
3. 対応する仮想環境における Python のインストール先を確認したい場合は、以下のコマンドを実行してください

Windows

  python -c "import sys; print(sys.executable)"

macOS

which python

現在実行しようとしている操作の意味を十分に理解していない限り、その操作によって対応する仮想環境で依存関係に関する問題が発生する可能性があります。この方法は慎重にご使用ください。

Terminal

お好みのターミナルアプリケーションを使って Python 環境にアクセスすることもできますが、その前に仮想環境を有効化する必要があります。

他のターミナルを使用する場合、操作に慣れていないと、誤って依存パッケージをシステム環境にインストールしてしまう可能性があります。この方法は慎重にご使用ください。

スクリーンショットには macOS のターミナルの例が表示されています。Windows をお使いの場合は、以下の手順に従って、お使いのシステム上で仮想環境を有効化してください。

1. ターミナルを開く

   お好みのターミナルアプリケーションを開き、cd コマンドで ComfyUI のインストール先ディレクトリへ移動します（例）：

   cd <あなたの ComfyUI インストール先ディレクトリ>/ComfyUI
   
2. 仮想環境を有効化

   ターミナルで以下のコマンドを入力し、仮想環境を有効化します。

   Windows

   .venv/Scripts/activate
   

   macOS

   source .venv/bin/activate
   

   有効化後、ターミナルのプロンプトに (ComfyUI) のような表示が現れます。これは仮想環境が正しく有効化されたことを示します。

3. 現在の Python 環境を確認

   which python コマンドを実行し、現在使用中の Python のパスを確認して、それがシステム環境ではないことを検証します。

​

ComfyUI Desktop のアンインストール方法

ComfyUI Desktop については、Windows 設定のシステムアンインストール機能を使用してソフトウェアのアンインストールを完了できます

ComfyUI Desktop のすべてのファイルを完全に削除したい場合は、以下のフォルダを手動で削除できます：

• C:\Users<ユーザー名>\AppData\Local@comfyorgcomfyui-electron-updater
• C:\Users<ユーザー名>\AppData\Local\Programs@comfyorgcomfyui-electron
• C:\Users<ユーザー名>\AppData\Roaming\ComfyUI

上記の操作では、以下のフォルダは削除されません。対応するファイルを削除する必要がある場合は、手動で削除してください：

• models ファイル
• custom nodes
• input/output ディレクトリ

​

トラブルシューティング

​

非対応デバイスが表示される場合

ComfyUI Desktop (Windows) は CUDA 対応の NVIDIA 製 GPU のみをサポートしているため、デバイスがサポートされていない場合にこの画面が表示されることがあります

• サポートされているデバイスに切り替えてください
• または、ComfyUI ポータブル版 の使用を検討するか、手動インストール を通じて ComfyUI を使用してください

​

エラーの特定

インストールに失敗した場合、以下の画面が表示されます。

エラーの原因を特定するには、以下の手順を実行することを推奨します：

1. Show Terminal をクリックして、エラー出力を確認する
2. Open Logs をクリックして、インストールログを確認する
3. 公式フォーラムを訪問し、類似のエラー報告を検索する
4. Reinstall をクリックして、再インストールを試行する

フィードバックを送信する前に、エラー出力およびログファイルを、GPT などのツールに提供することを推奨します。

上記の画像のように、対応するエラーの原因について GPT に質問するか、あるいは ComfyUI を完全に削除したうえで、再度インストールを試行してください。

​

エラー報告

インストール中に何らかのエラーが発生した場合、以下のいずれかの方法で類似するエラー報告がないか確認するか、または当社へエラーを報告してください。

• GitHub Issues: https://github.com/Comfy-Org/desktop/issues
• Comfy 公式フォーラム: https://forum.comfy.org/

エラー報告を送信する際は、問題の特定および調査を迅速に行えるよう、以下のログファイルおよび設定ファイルを必ず添付してください。

1. ログファイル

ファイル名	説明	保存場所
main.log	デスクトップアプリケーションおよびサーバー起動に関するログ（Electron プロセスから生成）	{log_path}
comfyui.log	ComfyUI の通常動作に関するログ（例：コア ComfyUI プロセスのターミナル出力）	{log_path}

2. 設定ファイル

ファイル名	説明	保存場所
extra_model_paths.yaml	ComfyUI がモデルおよびカスタムノードを検索する追加パスを指定するファイル	{config_path}
config.json	アプリケーションの設定を含むファイル。このファイルは通常、直接編集しないでください。	{config_path}