メインコンテンツへスキップ
ComfyUI Desktop は、通常のソフトウェアのようにインストールできるスタンドアロン版です。 Python 環境と依存関係のクイックインストールと自動構成をサポートし、既存の ComfyUI 設定、モデル、ワークフロー、ファイルのワンクリックインポートにも対応しています。 ComfyUI Desktop はオープンソースプロジェクトです。完全なコードはこちらをご覧ください。
ComfyUI Desktop (macOS) は現時点では Apple Silicon のみをサポートします
このチュートリアルでは、ソフトウェアのインストールプロセスをガイドし、関連する設定の詳細について説明します。
ComfyUI Desktop はまだ Beta 状態のため、実際のインストールプロセスは変更される可能性があります

​
ComfyUI Desktop (macOS) ダウンロード

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

macOS 用ダウンロード

​
Homebrew によるインストール

ComfyUI Desktop は Homebrew 経由でもインストールできます。 
brew install comfyui

​
ComfyUI Desktop インストール手順

ダウンロードしたインストールパッケージファイルをダブルクリックします。画像に示すように、矢印に従って ComfyUI アプリケーションを Applications フォルダにドラッグします。 ComfyUI インストールパッケージ インストールパッケージを開いた後、フォルダが以下のように表示され（アイコンに禁止マークが表示される）、現在のシステムバージョンが ComfyUI Desktop と互換性がないことを示しています。 ComfyUI logo 次に、Launchpad で ComfyUI アイコン を見つけてクリックし、ComfyUI 初期化設定に入ります。 ComfyUI Launchpad

​
ComfyUI Desktop 初期化プロセス

1

開始画面

ComfyUI インストール手順 - 開始Get Started をクリックして初期化を開始します。
2

GPU の選択

ComfyUI インストール手順 - GPU 選択3 つのオプションがあります。
  1. MPS (推奨): Metal Performance Shaders (MPS) は、Apple デバイス上で GPU を使用してコンピューティングおよび機械学習タスクを加速する Apple 社製のフレームワークで、PyTorch などのフレームワークをサポートしています。
  2. 手動構成: Python ランタイム環境を手動でインストールおよび構成する必要があります。構成方法を知っている場合を除き、これを選択しないでください。
  3. CPU モードを有効化: 開発者および特別なケースのみ用です。必要であると確信している場合を除き、これを選択しないでください。
特別な事情がない限り、画像に示すように MPS を選択し、Next をクリックして進んでください。
3

インストール場所

ComfyUI インストール手順 - インストール場所このステップでは、ComfyUI の以下の関連コンテンツのインストール場所を選択します。
  • Python 環境
  • モデルファイル
  • カスタムノード
推奨事項:
  • ComfyUI のインストールディレクトリとして、別の空のフォルダを作成してください。
  • ComfyUI Desktop の正常なインストールを確保するために、ディスクに少なくとも 5GB の空き容量があることを確認してください。
すべてのファイルがこのディレクトリにインストールされるわけではありません。一部のファイルは macOS システムディレクトリに配置されます。ComfyUI デスクトップ版のアンインストールについては、このガイドのアンインストールセクションを参照してください。
4

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

ComfyUI インストール手順 - ファイル移行このステップでは、既存の ComfyUI インストールコンテンツを ComfyUI Desktop に移行できます。既存の ComfyUI インストールディレクトリを選択すると、インストーラーが自動的に以下を認識します。
  • ユーザーファイル
  • モデル: コピーはされず、デスクトップ版とリンクされるだけです。
  • カスタムノード: ノードは再インストールされます。
心配しないでください。このステップでモデルファイルはコピーされません。必要に応じてオプションをチェックまたはチェック解除し、Next をクリックして続行してください。
5

デスクトップ設定

ComfyUI インストール手順 - デスクトップ設定これらは設定項目です。
  1. 自動更新: ComfyUI の更新が利用可能な場合に自動更新を設定するかどうか。
  2. 使用状況メトリクス: 有効にすると、ComfyUI の改善に役立てるために匿名の使用データを収集します。
  3. ミラー設定: プログラムは Python をダウンロードして環境インストールを完了するためにインターネットアクセスが必要です。インストール中に赤い ❌ が表示されてインストール失敗の原因となる可能性がある場合は、以下の手順に従ってください。
ComfyUI インストール手順 - ミラー設定ミラー設定を展開して、具体的に失敗しているミラーを見つけます。このスクリーンショットでは、エラーは 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 ミラー

6

インストール完了

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

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

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

​
最初の画像生成

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

最初の画像生成

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

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

現在、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）に保存してください。
また、このサンプル設定ファイルは こちら からも参照できます。
該当ファイルが存在しない場合は、任意のテキストエディタで新規作成してください。

​
設定例

たとえば、以下の構造でモデルファイルを格納している場合： 
📁 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 環境にアクセスできます。ComfyUI デスクトップ版ターミナル
  1. メニューバーのアイコンをクリックして、下部パネルを開きます
  2. Terminal をクリックしてターミナルを起動します
  3. 対応する仮想環境における Python のインストール先を確認したい場合は、以下のコマンドを実行してください
  python -c "import sys; print(sys.executable)"
現在実行しようとしている操作の意味を十分に理解していない限り、その操作によって対応する仮想環境で依存関係に関する問題が発生する可能性があります。この方法は慎重にご使用ください。

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

ComfyUI Desktop の場合、Applications フォルダから ComfyUI を直接削除できます。 ComfyUI Desktop のすべてのファイルを完全に削除したい場合は、以下のフォルダを手動で削除できます。 
~/Library/Application Support/ComfyUI
上記の操作では、以下のフォルダは削除されません。対応するファイルを削除する必要がある場合は、手動で削除してください。
  • モデルファイル
  • カスタムノード
  • 入力/出力ディレクトリ

​
トラブルシューティング

​
エラーの特定

インストールに失敗した場合、以下の画面が表示されます。 ComfyUI のインストール失敗 エラーの原因を特定するには、以下の手順を実行することを推奨します：
  1. Show Terminal をクリックして、エラー出力を確認する
  2. Open Logs をクリックして、インストールログを確認する
  3. 公式フォーラムを訪問し、類似のエラー報告を検索する
  4. Reinstall をクリックして、再インストールを試行する
フィードバックを送信する前に、エラー出力およびログファイルを、GPT などのツールに提供することを推奨します。 ComfyUI のインストール失敗 - エラーログ ComfyUI のインストール失敗 - GPT によるフィードバック 上記の画像のように、対応するエラーの原因について GPT に質問するか、あるいは ComfyUI を完全に削除したうえで、再度インストールを試行してください。

​
エラー報告

インストール中に何らかのエラーが発生した場合、以下のいずれかの方法で類似するエラー報告がないか確認するか、または当社へエラーを報告してください。 エラー報告を送信する際は、問題の特定および調査を迅速に行えるよう、以下のログファイルおよび設定ファイルを必ず添付してください。
  1. ログファイル
ファイル名説明保存場所
main.logデスクトップアプリケーションおよびサーバー起動に関するログ（Electron プロセスから生成）{log_path}
comfyui.logComfyUI の通常動作に関するログ（例：コア ComfyUI プロセスのターミナル出力）{log_path}
ComfyUI ログファイルの保存場所
  1. 設定ファイル
ファイル名説明保存場所
extra_model_paths.yamlComfyUI がモデルおよびカスタムノードを検索する追加パスを指定するファイル{config_path}
config.jsonアプリケーションの設定を含むファイル。このファイルは通常、直接編集しないでください。{config_path}
ComfyUI 設定ファイルの保存場所