Documentation Index Fetch the complete documentation index at: https://dripart-mintlify-e28287af.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
ComfyUI Desktop は、通常のソフトウェアのようにインストールできるスタンドアロン版です。Python 環境および依存関係 のクイックインストールと自動設定をサポートし、既存の ComfyUI 設定、モデル、ワークフロー、ファイルのワンクリックインポートにも対応しています。既存の ComfyUI ポータブル版 からデスクトップ版へ迅速に移行することも可能です。ComfyUI Desktop はオープンソースプロジェクトです。完全なコードは こちら からご覧ください。
ComfyUI Desktop のハードウェア要件：
このチュートリアルでは、ソフトウェアのインストールプロセスをガイドし、関連する設定の詳細について説明します。
ComfyUI Desktop は現在 ベータ版 であるため、実際のインストールプロセスは変更される可能性があります
ComfyUI Desktop (Windows) ダウンロード 以下のボタンをクリックして、Windows 用 ComfyUI Desktop のインストールパッケージをダウンロードしてください。
Windows 用ダウンロード (NVIDIA)
ComfyUI Desktop インストール手順 ダウンロードしたインストールパッケージファイルをダブルクリックすると、自動インストールが実行され、デスクトップに ComfyUI Desktop のショートカットが作成されます。
対応するショートカットをダブルクリックして、ComfyUI 初期化設定画面に入ります。
ComfyUI Desktop 初期化プロセス
GPU の選択
3 つのオプションがあります：
Nvidia GPU (推奨): pytorch および CUDA を直接サポートManual Configuration: Python ランタイム環境を手動でインストールおよび設定する必要があります。設定方法を知っている場合以外は選択しないでくださいEnable CPU Mode: 開発者および特殊なケース専用です。必要であることが確実な場合以外は選択しないでください 特別な事情がない限り、図のように NVIDIA を選択し、Next をクリックして進んでください
インストール場所
このステップでは、以下の ComfyUI コンテンツのインストール場所を選択します：
Python 環境 Models モデルファイル Custom Nodes カスタムノード 推奨事項：
インストール場所として SSD を選択してください。これにより、モデルへのアクセス時の ComfyUI パフォーマンスが向上します。
ComfyUI インストールディレクトリとして、別の空のフォルダを作成してください
ComfyUI Desktop のインストールを確保するために、対応するディスクに少なくとも 15GB 程度のディスク容量があることを確認してください
すべてのファイルがこのディレクトリにインストールされるわけではありません。一部のファイルは C ドライブにインストールされたままになります。後でアンインストールする必要がある場合は、このガイドのアンインストールセクションを参照して、ComfyUI Desktop の完全なアンインストールを完了できます
このステップを完了したら、Next をクリックして次のステップに進みます
既存のインストールから移行 (オプション)
このステップでは、既存の ComfyUI インストール内容を ComfyUI Desktop に移行できます。図のように、元の D:\ComfyUI_windows_portable\ComfyUI インストールディレクトリを選択しました。インストーラーは自動的に以下を認識します：
ユーザーファイル Models: コピーされず、デスクトップ版とリンクされるだけですCustom Nodes: ノードは再インストールされます 心配しないでください。このステップではモデルファイルはコピーされません。必要に応じてオプションをチェックまたはチェック解除できます。Next をクリックして続行します
デスクトップ設定
これらは設定項目です：
Automatic Updates: ComfyUI の更新が利用可能な場合に自動更新を設定するかどうかUsage Metrics: 有効にすると、ComfyUI の改善に役立てるために匿名の利用状況データ を収集します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 ミラー Torch ミラー
インストールの完了
すべて正しければ、インストーラーは完了し、自動的に ComfyUI Desktop インターフェースに入ります。これでインストール成功です 重要：/resource/ComfyUI フォルダーを変更しないでください /resource/ComfyUI フォルダー内にコンテンツを追加したり、変更したりしないでください。このフォルダー内のすべてのコンテンツは、ComfyUI Desktop の更新時にリセットされます。他の ComfyUI バージョンとは異なり、Desktop 版ではこのフォルダーが自動的に管理されます。インストール時に、モデル、カスタムノード、その他のユーザー用ファイルの保存先としてカスタムパスを選択しましたので、そちらの場所をご利用ください。
最初の画像生成 インストールが完了したら、以下のセクションを参照して、ComfyUI を使い始めてください。
最初の画像生成 このチュートリアルでは、初めてのモデルのインストールおよびテキストから画像を生成する手順を案内します
ComfyUI デスクトップ版の更新方法 現在、ComfyUI デスクトップ版の更新は自動検出による更新を採用しています。設定で自動更新が有効になっていることをご確認ください。
また、手動で利用可能な更新を確認することもできます。メニュー → ヘルプ → 更新を確認 を選択してください。
外部モデルパスの追加 ComfyUI/models ディレクトリの外部でモデルファイルを管理したい場合、以下のような理由が考えられます。
複数の ComfyUI インスタンスを運用しており、ディスク容量の節約のためにモデルファイルを共有したい
WebUI などの異なる種類の GUI アプリケーションを併用しており、それらで共通のモデルファイルを使いたい
モデルファイルが認識されない、または見つからない
このため、extra_model_paths.yaml 設定ファイルを用いて、追加のモデル検索パスを指定する方法を提供しています。
設定ファイルの開き方 ポータブル版／手動インストール版
ComfyUI Desktop
ポータブル版 や 手動インストール版 の 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 アプリケーションをご利用の場合、以下の画像を参考に、追加モデル設定ファイルを開くことができます：または、直接以下のパスから開くことも可能です： C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml
~/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 環境の使い方 デスクトップアプリに内蔵されたターミナルを使用して、Python 環境にアクセスできます。
メニューバーのアイコンをクリックして、下部パネルを開きます
Terminal をクリックしてターミナルを起動します対応する仮想環境における Python のインストール先を確認したい場合は、以下のコマンドを実行してください
python -c "import sys; print(sys.executable)"
現在実行しようとしている操作の意味を十分に理解していない限り、その操作によって対応する仮想環境で依存関係に関する問題が発生する可能性があります。この方法は慎重にご使用ください。
お好みのターミナルアプリケーションを使って Python 環境にアクセスすることもできますが、その前に仮想環境を有効化する必要があります。 他のターミナルを使用する場合、操作に慣れていないと、誤って依存パッケージをシステム環境にインストールしてしまう可能性があります。この方法は慎重にご使用ください。
スクリーンショットには macOS のターミナルの例が表示されています。Windows をお使いの場合は、以下の手順に従って、お使いのシステム上で仮想環境を有効化してください。
ターミナルを開く
お好みのターミナルアプリケーションを開き、cd コマンドで ComfyUI のインストール先ディレクトリへ移動します（例）： cd <あなたの ComfyUI インストール先ディレクトリ>/ComfyUI
仮想環境を有効化
ターミナルで以下のコマンドを入力し、仮想環境を有効化します。 source .venv/bin/activate
有効化後、ターミナルのプロンプトに (ComfyUI) のような表示が現れます。これは仮想環境が正しく有効化されたことを示します。
現在の Python 環境を確認
which python コマンドを実行し、現在使用中の 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 のみをサポートしているため、デバイスがサポートされていない場合にこの画面が表示されることがあります
ウイルス対策ソフトが uv.exe を悪意のあるファイルとして検出する ComfyUI Desktop は Python 環境を管理するために uv360 Total Security 、Windows Defender 、BitDefender 、DeepInstinct などの一部のウイルス対策製品が、uv.exe を悪意のあるファイルとして誤検出することがあります。これは uv 自体の既知の誤検出 であり、ComfyUI とは関係ありません。
症状：
インストールまたは更新中に、ウイルス対策ソフトが uv.exe を隔離または削除する
Python 環境のセットアップ中にインストールが失敗する
ウイルス対策の警告後に「Python 環境のインストールに失敗しました」などのエラーが発生する
対処法： ComfyUI のインストールディレクトリをウイルス対策ソフトの信頼済みリスト / ホワイトリストに追加してから、再インストールまたは修復インストールを行ってください。ホワイトリストに追加するディレクトリ：
インストール手順で選択した ComfyUI のインストールディレクトリ
C:\Users\<ユーザー名>\AppData\Local\Programs\@comfyorgcomfyui-electronC:\Users\<ユーザー名>\AppData\Roaming\ComfyUI
参考： この問題は uv の上流プロジェクトで追跡されています — astral-sh/uv#1587 、#10079 、#12621 、#15011 を参照してください。エラーの特定 インストールに失敗した場合、以下の画面が表示されます。
エラーの原因を特定するには、以下の手順を実行することを推奨します：
Show Terminal をクリックして、エラー出力を確認するOpen Logs をクリックして、インストールログを確認する公式フォーラムを訪問し、類似のエラー報告を検索する
Reinstall をクリックして、再インストールを試行する
フィードバックを送信する前に、エラー出力 およびログファイル を、GPT などのツールに提供することを推奨します。
上記の画像のように、対応するエラーの原因について GPT に質問するか、あるいは ComfyUI を完全に削除したうえで、再度インストールを試行してください。
エラー報告 インストール中に何らかのエラーが発生した場合、以下のいずれかの方法で類似するエラー報告がないか確認するか、または当社へエラーを報告してください。
エラー報告を送信する際は、問題の特定および調査を迅速に行えるよう、以下のログファイルおよび設定ファイルを必ず添付してください。
ログファイル
ファイル名 説明 保存場所 main.logデスクトップアプリケーションおよびサーバー起動に関するログ（Electron プロセスから生成） {log_path}comfyui.logComfyUI の通常動作に関するログ（例：コア ComfyUI プロセスのターミナル出力） {log_path}
設定ファイル
ファイル名 説明 保存場所 extra_model_paths.yamlComfyUI がモデルおよびカスタムノードを検索する追加パスを指定するファイル {config_path}config.jsonアプリケーションの設定を含むファイル。このファイルは通常、直接編集しないでください。 {config_path}
