Skip to content

ComfyUI Desktop User Guide

ComfyUI Desktop is the official desktop application launched by ComfyUI for running ComfyUI. It currently supports Windows and MacOS systems (MacOS 11.0 and above) and is still in Beta version.

Since this version is still a Beta version, there may be some issues. If you are not a user who likes to try and tinker repeatedly, it is recommended that you choose the official portable version.

Note: Scroll to the bottom of the page to see the download link

For any issues, please provide feedback on the official forum: https://forum.comfy.org/ For any issues, please submit them on the official Github repository: https://github.com/Comfy-Org/desktop/issues

💡

When providing feedback, please include the corresponding log error logs and screenshots to help the official team get better feedback. Additionally, it is recommended to search the forum content before providing feedback. If there are similar issues, please refer to the corresponding content or comment on the original post.

Official ComfyUI Desktop Installation Guide

Since the official installation documentation is very detailed, if you are good at English, you can directly refer to the following documentation. Official ComfyUI Installation Documentation: ComfyUI Desktop User Guide

However, since this is a multilingual documentation site, I have reorganized the tutorial here to help users who are not familiar with English understand the installation process.

ComfyUI Desktop Installation Guide

Below is the installation video from ComfyUI official, but it does not have detailed instructions. I will provide detailed supplementary instructions below in combination with the official documentation.

Step 1: Run the installer to install

** Windows version installation interface** ComfyUI Desktop Windows Installation Double-click the EXE file, and the installation will begin automatically. After installation, a ComfyUI Desktop shortcut will be added to the desktop automatically.

** Mac version installation interface** ComfyUI Desktop Mac Installation Double-click the corresponding dmg, then drag the corresponding software icon to the Applications folder to complete the installation of the installer.

  • If your icon is the same as the one in the picture above, with a transparent prohibition symbol, then unfortunately your Mac does not support this version.

Step 2: Start the ComfyUI Desktop Setup program to start the initialization installation

After completing the first step, your Windows desktop / system menu Lanchpad will have a ComfyUI Desktop shortcut. Click to run to start the installation of ComfyUI Desktop.

This step requires selecting the installation location for ComfyUI Desktop, creating the following content in the corresponding folder:

  • Python runtime environment
  • ComfyUI Desktop related files

This step will take up about 15GB of disk space.

  • Please ensure that your hard drive has enough free space.
  • If possible, choose to install on an SSD to speed up model loading and software operation (my personal suggestion).

Refer to the screenshot below and choose the location where you want to install.

Windows version installation interface

ComfyUI Desk Windows Installation Location Selection

Mac version installation interface

ComfyUI Desk Windows Installation Location Selection

Step 3: Import existing installation information from the current ComfyUI project (optional)

ComfyUI Desktop Import Existing Installation Information

If you do not have a corresponding installation, you can ignore this step. If you have a ComfyUI installation package, such as the official portable version ComfyUI_windows_portable, you can choose whether to migrate. The migration function will handle the following content:

  • Link the location of existing model files (just reference the model address in ComfyUI Desktop, it will not copy model resources causing extra space occupation)
  • Migrate user settings files
  • Migrate your workflow files

Currently unsupported migration content:

  • Custom nodes (plugins)

In the interface below, select the installation location of your ComfyUI, such as D:\ComfyUI_windows_portable\ComfyUI Note that it is the ComfyUI directory so that the program can successfully link the corresponding models and related user resources.

ComfyUI Installation Folder

Step 4: User settings

User Settings

This step is for preference settings and provides two options. You can choose as needed:

  • First option: Whether to enable automatic updates for ComfyUI Desktop
  • Second option: Usage analysis, mainly to collect some anonymous usage data and non-sensitive data for developers to help improve ComfyUI Desktop.

Step 5: Initialization of ComfyUI Desktop Python environment

This step is mainly for installing the necessary Python environment to run ComfyUI. If the installation is successful, you will enter this step, which is automatically executed by the program. Setup Python

If unsuccessful, you will see a screenshot like mine below. Yes! I, the author, have tried several times and still failed!! ComfyUI Desktop Installation Failed

In the screenshot, you can see Unable to start ComfyUI At this time, you can choose Open Logs, and provide the corresponding screenshot and log file to the official forum. Click Report Issue to jump to the official forum feedback section. Remember to submit screenshots and logs to help the official team better locate the problem.

If I have any new content about the installation of ComfyUI Desktop, I will continue to update it in this article.

How to Uninstall ComfyUI Desktop

Uninstall ComfyUI Desktop on Windows System

  1. Simple Uninstall (there will still be residual files) Uninstall the program directly in the system settings.

This uninstallation will not delete your downloaded model files/custom nodes/input/output files, etc.

  1. Complete Uninstall If you need to completely uninstall ComfyUI Desktop, please remove the following folders:
  • C:\Users\WINDOWS\AppData\Local@comfyorgcomfyui-electron-updater
  • C:\Users\WINDOWS\AppData\Roaming\ComfyUI

Additionally, by removing the installation file location selected during installation, you can delete all related ComfyUI Desktop files.

💡

If the installation directory is deleted, model/custom nodes/input/output files will also be removed.

Uninstall ComfyUI Desktop on Mac System

  1. Simple Uninstall (there will still be residual files) Simply delete the ComfyUI package in Applications.

This uninstallation will not delete your downloaded model files/custom nodes/input/output files, etc.

  1. Complete Uninstall If you need to completely uninstall ComfyUI Desktop, please remove the following folder:
  • /Users/Library/Application Support/ComfyUI

Additionally, by removing the installation file location selected during installation, you can delete all related ComfyUI Desktop files.

💡

If the installation directory is deleted, model/custom nodes/input/output files will also be removed.