ComfyUI Desktop is a standalone installation version that can be installed like regular software. It supports quick installation and automatic configuration of the Python environment and dependencies, and supports one-click import of existing ComfyUI settings, models, workflows, and files. You can quickly migrate from an existing ComfyUI Portable version to the Desktop version.

ComfyUI Desktop is an open source project, please visit the full code here

ComfyUI Desktop hardware requirements:

  • NVIDIA GPU

This tutorial will guide you through the software installation process and explain related configuration details.

As ComfyUI Desktop is still in Beta status, the actual installation process may change

​
ComfyUI Desktop (Windows) Download

Please click the button below to download the installation package for Windows ComfyUI Desktop

Download for Windows (NVIDIA)

​
ComfyUI Desktop Installation Steps

Double-click the downloaded installation package file, which will first perform an automatic installation and create a ComfyUI Desktop shortcut on the desktop

Double-click the corresponding shortcut to enter ComfyUI initialization settings

​
ComfyUI Desktop Initialization Process

1

Start Screen

Click Get Started to begin initialization

2

Select GPU

The three options are:

  1. Nvidia GPU (Recommended): Direct support for pytorch and CUDA
  2. Manual Configuration: You need to manually install and configure the python runtime environment. Don’t select this unless you know how to configure
  3. Enable CPU Mode: For developers and special cases only. Don’t select this unless you’re sure you need it

Unless there are special circumstances, please select NVIDIA as shown and click Next to proceed

3

Install location

In this step, you will select the installation location for the following ComfyUI content:

  • Python Environment
  • Models Model Files
  • Custom Nodes Custom Nodes

Recommendations:

  • Please select a solid-state drive as the installation location, which will increase ComfyUI’s performance when accessing models.
  • Please create a separate empty folder as the ComfyUI installation directory
  • Please ensure that the corresponding disk has at least around 15G of disk space to ensure the installation of ComfyUI Desktop
Not all files are installed in this directory, some files will still be installed on the C drive, and if you need to uninstall in the future, you can refer to the uninstallation section of this guide to complete the full uninstallation of ComfyUI Desktop

After completing this step, click Next to proceed to the next step

4

Migrate from Existing Installation (Optional)

In this step you can migrate your existing ComfyUI installation content to ComfyUI Desktop. As shown, I selected my original D:\ComfyUI_windows_portable\ComfyUI installation directory. The installer will automatically recognize:

  • User Files
  • Models: Will not be copied, only linked with desktop version
  • Custom Nodes: Nodes will be reinstalled

Don’t worry, this step won’t copy model files. You can check or uncheck options as needed. Click Next to continue

5

Desktop Settings

These are preference settings:

  1. Automatic Updates: Whether to set automatic updates when ComfyUI updates are available
  2. Usage Metrics: If enabled, we will collect anonymous usage data to help improve ComfyUI
  3. Mirror Settings: Since the program needs internet access to download Python and complete environment installation, if you see a red ❌ during installation indicating this may cause installation failure, please follow the steps below

Expand the mirror settings to find the specific failing mirror. In this screenshot the error is Python Install Mirror failure.

You can use either of these methods to resolve mirror link errors:

  1. Find available mirror sources and update mirrors
  2. Make sure Python 3.12 + or above is installed

For different mirror errors, you can refer to the following content to try to manually find different mirrors and replace them

The following cases mainly apply to users in China

Python Installation Mirror

You need to find the mirror address of GitHub and build a mirror address pointing to the python-build-standalone repository releases.

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

Build a link in the following pattern

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

PyPI Mirror

Torch Mirror

[To be updated]

6

Complete the installation

If everything is correct, the installer will complete and automatically enter the ComfyUI Desktop interface, then the installation is successful

​
First Image Generation

After successful installation, you can refer to the section below to start your ComfyUI journey~

First Image Generation

This tutorial will guide you through your first model installation and text-to-image generation

​
How to Update ComfyUI Desktop

Currently, ComfyUI Desktop updates use automatic detection updates, please ensure that automatic updates are enabled in the settings

​
How to Uninstall ComfyUI Desktop

For ComfyUI Desktop you can use the system uninstall function in Windows Settings to complete software uninstallation

If you want to completely remove all ComfyUI Desktop files, you can manually delete these folders:

  • C:\Users<your username>\AppData\Local@comfyorgcomfyui-electron-updater
  • C:\Users<your username>\AppData\Local\Programs@comfyorgcomfyui-electron
  • C:\Users<your username>\AppData\Roaming\ComfyUI

The above operations will not delete your following folders. If you need to delete corresponding files, please delete manually:

  • models files
  • custom nodes
  • input/output directories

​
Troubleshooting

​
Display unsupported devices

Since ComfyUI Desktop (Windows) only supports NVIDIA GPUs with CUDA, you may see this screen if your device is not supported

​
​Error identification​

If installation fails, you should see the following screen

It is recommended to take these steps to find the error cause:

  1. Click Show Terminal to view error output
  2. Click Open Logs to view installation logs
  3. Visit official forum to search for error reports
  4. Click Reinstall to try reinstalling

Before submitting feedback, it’s recommended to provide the error output and log files to tools like GPT

As shown above, ask the GPT for the cause of the corresponding error, or remove ComfyUI completely and retry the installation.

​
Feedback Installation Failure

If you encounter any errors during installation, please check if there are similar error reports or submit errors to us through:

When submitting error reports, please ensure you include the following logs and configuration files to help us locate and investigate the issue:

  1. Log Files
FilenameDescriptionLocation
main.logContains logs related to desktop application and server startup from the Electron process
comfyui.logContains logs related to ComfyUI normal operation, such as core ComfyUI process terminal output

  1. Configuration Files
FilenameDescriptionLocation
extra_models_config.yamlContains additional paths where ComfyUI will search for models and custom nodes
config.jsonContains application configuration. This file should not be edited directly

Was this page helpful?

Suggest edits
IntroductionMacOS Desktop Version