macOS デスクトップ版

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

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 Desktop と互換性がないことを示しています。

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

   特別な事情がない限り、画像に示すように MPS を選択し、Next をクリックして進んでください。

3. インストール場所

   

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

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

   推奨事項:

   • ComfyUI のインストールディレクトリとして、別の空のフォルダを作成してください。
   • ComfyUI Desktop の正常なインストールを確保するために、ディスクに少なくとも 5GB の空き容量があることを確認してください。

   すべてのファイルがこのディレクトリにインストールされるわけではありません。一部のファイルは macOS システムディレクトリに配置されます。ComfyUI デスクトップ版のアンインストールについては、このガイドのアンインストールセクションを参照してください。
4. 既存インストールからの移行 (オプション)

   

   このステップでは、既存の ComfyUI インストールコンテンツを ComfyUI Desktop に移行できます。既存の ComfyUI インストールディレクトリを選択すると、インストーラーが自動的に以下を認識します。

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

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

5. デスクトップ設定

   

   これらは設定項目です。

   1. 自動更新: ComfyUI の更新が利用可能な場合に自動更新を設定するかどうか。
   2. 使用状況メトリクス: 有効にすると、ComfyUI の改善に役立てるために匿名の使用データを収集します。
   3. ミラー設定: プログラムは 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 のパスを確認して、それがシステム環境ではないことを検証します。

4. 以上の手順を完了すると、対応する Python 仮想環境が有効化されます。この環境内で、依存関係のインストールなどの操作を続行できます。

​

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

ComfyUI Desktop の場合、Applications フォルダから ComfyUI を直接削除できます。

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

~/Library/Application Support/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}