Manual Installation — Local Self-Hosted

For the installation of ComfyUI, it is mainly divided into several steps:

Create a virtual environment(avoid polluting the system-level Python environment)
Clone the ComfyUI code repository
Install dependencies
Start ComfyUI

You can also refer to ComfyUI CLI to install ComfyUI, it is a command line tool that can easily install ComfyUI and manage its dependencies.

Create a virtual environment

Independent virtual environments are necessary because ComfyUI’s dependencies may conflict with other dependencies on the system, and it can also avoid polluting the system-level Python environment.

Install Miniconda. This will help you install the correct versions of Python and other libraries needed by ComfyUI. Create an environment with Conda.

conda create -n comfyenv
conda activate comfyenv

Clone the ComfyUI code repository

You need to ensure that you have installed Git on your system. First, you need to open the terminal (command line), then clone the code repository.

Windows
Linux
MacOS

If you have not installed Microsoft Visual C++ Redistributable, please install it here.

git clone https://github.com/Comfy-Org/ComfyUI.git

Install GPU and ComfyUI dependencies

Install GPU dependencies

Install GPU Dependencies

Nvidia

pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

Alternatively, you can install the nightly version of PyTorch.

Install Nightly

Install Nightly version (might be more risky)

pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu132

AMD

pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

Alternatively, you can install the nightly version of PyTorch (ROCm 7.2).

Install Nightly

Install Nightly version (might be more risky)

pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.2

Mac ARM Silicon

conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly

Install ComfyUI dependencies

cd ComfyUI
pip install -r requirements.txt

Start ComfyUI

Start the application

cd ComfyUI
python main.py

Run python main.py --help for built-in help, or see the Startup Flags reference for a complete list of command-line options.

For advanced server configuration (custom port, LAN access, VRAM modes, and more), see the Startup Flags reference.

How to update ComfyUI

pull the latest code

Use the command line to enter the installation path of ComfyUI, then pull the latest code.

cd <installation path>/ComfyUI
git pull

install the dependencies

Use the command line to enter the installation path of ComfyUI, then install the dependencies.

You need to ensure that the current Python environment is the ComfyUI virtual environment, otherwise the dependencies will be installed to the system-level Python environment, polluting the system-level Python environment.

    pip install -r requirements.txt

Adding Extra Model Paths

If you want to manage your model files outside of ComfyUI/models, you may have the following reasons:

You have multiple ComfyUI instances and want them to share model files to save disk space
You have different types of GUI programs (such as WebUI) and want them to use the same model files
Model files cannot be recognized or found

We provide a way to add extra model search paths via the extra_model_paths.yaml configuration file

Open Config File

Portable/Manual Install
Comfy Desktop

For the ComfyUI version such as portable and manual, you can find an example file named extra_model_paths.yaml.example in the root directory of ComfyUI:

ComfyUI/extra_model_paths.yaml.example

Copy and rename it to extra_model_paths.yaml for use. Keep it in ComfyUI’s root directory at ComfyUI/extra_model_paths.yaml. You can also find the config example file here

If you are using the Comfy Desktop application, you can follow the image below to open the extra model config file:

Or open it directly at:

Windows
macOS

C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml

~/Library/Application Support/ComfyUI/extra_models_config.yaml

You should keep the file in the same directory, should not move these files to other places.

If the file does not exist, you can create it yourself with any text editor.

Example Structure

Suppose you want to add the following model paths to ComfyUI:

📁 YOUR_PATH/
  ├── 📁models/
  |   ├── 📁 loras/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 checkpoints/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 vae/
  |   │   └── xxxxx.safetensors
  |   └── 📁 controlnet/
  |       └── xxxxx.safetensors

Then you can configure the extra_model_paths.yaml file like below to let ComfyUI recognize the model paths on your device:

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

For the desktop version, please add the configuration to the existing configuration path without overwriting the path configuration generated during installation. Please back up the corresponding file before modification, so that you can restore it when you make a mistake.

Or you can refer to the default extra_model_paths.yaml.example for more configuration options. After saving, you need to restart ComfyUI for the changes to take effect. Below is the original config example:

#Rename this to extra_model_paths.yaml and ComfyUI will load it


#config for a1111 ui
#all you have to do is change the base_path to where yours is installed
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

#config for comfyui
#your base path should be either an existing comfy install or a central folder where you store all of your models, loras, etc.

#comfyui:
#     base_path: path/to/comfyui/
#     # You can use is_default to mark that these folders should be listed first, and used as the default dirs for eg downloads
#     #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/

#other_ui:
#    base_path: path/to/ui
#    checkpoints: models/checkpoints
#    gligen: models/gligen
#    custom_nodes: path/custom_nodes

For example, if your WebUI is located at D:\stable-diffusion-webui\, you can modify the corresponding configuration to

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

Add Extra Custom Nodes Path

Besides adding external models, you can also add custom nodes paths that are not in the default path of ComfyUI

Please note that this will not change the default installation path of custom nodes, but will add an extra path search when starting ComfyUI. You still need to complete the installation of custom node dependencies in the corresponding environment to ensure the integrity of the running environment.

Below is a simple configuration example (MacOS), please modify it according to your actual situation and add it to the corresponding configuration file, save it and restart ComfyUI for the changes to take effect:

my_custom_nodes:
  custom_nodes: /Users/your_username/Documents/extra_custom_nodes

FAQ

Docker: ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search Docker Hub for community-maintained images. Note that none of these are official ComfyUI images, and they are not supported by the ComfyUI team. Use them at your own risk.

Get Started

Agent Tools / MCP

Basic Concepts

Interface Guide

Tutorials

Partner Nodes

Manual Installation — Local Self-Hosted

Create a virtual environment

Clone the ComfyUI code repository

Install GPU and ComfyUI dependencies

How to update ComfyUI

Adding Extra Model Paths

Open Config File

Example Structure

Add Extra Custom Nodes Path

FAQ

​Create a virtual environment

​Clone the ComfyUI code repository

​Install GPU and ComfyUI dependencies

​How to update ComfyUI

​Adding Extra Model Paths

​Open Config File

​Example Structure

​Add Extra Custom Nodes Path

​FAQ

Create a virtual environment

Clone the ComfyUI code repository

Install GPU and ComfyUI dependencies

How to update ComfyUI

Adding Extra Model Paths

Open Config File

Example Structure

Add Extra Custom Nodes Path

FAQ