如何在不同系统上手动安装 ComfyUI

本部分将指导你完成在 Windows、MacOS 以及 Linux 的手动安装过程

对于 ComfyUI 的安装， 主要分为几个步骤

1. 创建一个虚拟环境(避免污染系统级 Python 环境)
2. 克隆 ComfyUI 代码仓库
3. 安装依赖
4. 启动 ComfyUI

Python 3.13 支持非常好。如果你在 3.13 上遇到某些自定义节点依赖问题,可以尝试使用 3.12。

Python 3.14 可以工作，但需要在 requirements.txt 文件中注释掉 kornia 依赖（会导致 canny 节点失效），不建议使用。

你也可以参考 ComfyUI CLI 来安装 ComfyUI, 它是一个命令行工具，可以方便地安装 ComfyUI 并管理其依赖。

​

（可选）创建虚拟环境

独立的虚拟环境是必要的，因为 ComfyUI 的依赖可能会与系统上的其他依赖冲突，也可以避免对系统级 Python 环境的污染。

Install Miniconda. 这将帮助您安装 ComfyUI 所需的正确版本的 Python 和其他库。

使用 Conda 创建一个环境。

conda create -n comfyenv
conda activate comfyenv

​

克隆代码仓库

你需要保证你的系统上已经安装了 Git, 首先你需要打开终端（命令行）,然后克隆代码仓库。

Windows

如果你还没有安装 Microsoft Visual C++ Redistributable，请在这里安装

Linux

打开终端应用程序。

MacOS

打开终端应用程序。

git clone [e-mail]:comfyanonymous/ComfyUI.git

​

安装GPU 及 ComfyUI 依赖

1. 安装 GPU 依赖

   安装 GPU 依赖

   Nvidia

   Nvidia 用户应使用以下命令安装稳定版 pytorch：

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

   或者，您可以安装 PyTorch 的夜间版本。

   安装夜间版本

   安装夜间版本（可能风险更大）

   这是安装 pytorch 夜间版本的命令，可能会有一些性能改进：

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

   故障排除

   如果您遇到 “Torch not compiled with CUDA enabled” 错误，请使用以下命令卸载 torch：

   pip uninstall torch
   

   然后使用上述命令重新安装。

   AMD (Linux)

   AMD 用户可以使用 pip 安装 rocm 和 pytorch（如果尚未安装），这是安装稳定版本的命令：

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

   或者，您可以安装 PyTorch 的夜间版本。

   安装夜间版本

   安装夜间版本（可能风险更大）

   这是安装 ROCm 7.0 夜间版本的命令，可能会有一些性能改进：

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

   AMD 实验性支持 (Windows 和 Linux)

   Windows 和 Linux 的实验性支持。仅支持 RDNA 3、3.5 和 4。

   这些版本的硬件支持比上述版本少，但它们可以在 Windows 上运行。您还需要安装特定于您硬件的 PyTorch 版本。

   RDNA 3 (RX 7000 系列):

   pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/
   

   RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):

   pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/
   

   RDNA 4 (RX 9000 系列):

   pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/
   

   Intel

   Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在这里找到。

   选项 1: 安装 PyTorch xpu

   要安装 PyTorch xpu，请使用以下命令：

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

   安装夜间版本

   安装夜间版本（可能风险更大）

   这是安装 PyTorch xpu 夜间版本的命令，可能会有一些性能改进：

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

   选项 2: Intel Extension for PyTorch (IPEX)

   或者，Intel Extension for PyTorch (IPEX) 支持的 Intel GPU 可以利用 IPEX 来提高性能。

   访问安装页面了解更多信息。

   Mac ARM Silicon

   您可以在任何最新的 macOS 版本上的 Apple Mac silicon（M1 或 M2）中安装 ComfyUI。

   安装 pytorch nightly。有关说明，请阅读 Accelerated PyTorch training on Mac Apple Developer 指南（确保安装最新的 pytorch nightly）。

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

   记得将您的模型、VAE、LoRA 等添加到相应的 Comfy 文件夹（models/checkpoints、models/vae 等）。

   Ascend NPUs

   适用于与 Ascend Extension for PyTorch (torch_npu) 兼容的模型。要开始使用，请确保您的环境满足安装页面上列出的先决条件。

   分步指南：

   1. 首先，如有必要，按照 torch-npu 安装页面中指定的要求，为 Linux 安装推荐或更新的内核版本。
   2. 继续安装 Ascend Basekit，其中包括驱动程序、固件和 CANN，按照您特定平台的说明进行操作。
   3. 接下来，按照安装页面上的平台特定说明安装 torch-npu 所需的软件包。
   4. 最后，按照 Linux 的 ComfyUI 手动安装指南进行操作。安装所有组件后，您可以按照前面所述运行 ComfyUI。

   Cambricon MLUs

   适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。

   分步指南：

   1. 按照安装页面上的平台特定说明安装 Cambricon CNToolkit
   2. 接下来，按照安装页面上的说明安装 PyTorch(torch_mlu)
   3. 通过运行 python main.py 启动 ComfyUI

   Iluvatar Corex

   适用于与 Iluvatar Extension for PyTorch 兼容的模型。

   分步指南：

   1. 按照安装页面上的平台特定说明安装 Iluvatar Corex Toolkit
   2. 通过运行 python main.py 启动 ComfyUI
2. 安装 ComfyUI 依赖

   cd ComfyUI
   pip install -r requirements.txt
   
3. 启动 ComfyUI

   启动 ComfyUI

   cd ComfyUI
   python main.py
   

​

如何更新 ComfyUI

1. 拉取最新代码

   使用命令行进入 ComfyUI 的安装路径，然后拉取最新代码。

   cd <安装路径>/ComfyUI
   git pull
   
2. 安装依赖

   使用命令行进入 ComfyUI 的安装路径，然后安装依赖。

   你需要确保当前的 Python 环境是 ComfyUI 的虚拟环境，否则依赖会安装到系统级 Python 环境，污染系统级 Python 环境。

       pip install -r requirements.txt
   

​

添加外部模型路径

如果你想要在 ComfyUI/models 之外管理你的模型文件，可能出于以下原因:

• 你有多个 ComfyUI 实例，你想要让这些实例共享模型文件，从而减少磁盘占用
• 你有多个不同的类型的 GUI 程序，如：WebUI, 你想要他们共用模型文件
• 模型文件无法被识别或读取到

我们提供了通过 extra_model_paths.yaml 配置文件来添加额外模型搜索路径的方法。

​

不同 ComfyUI 版本配置文件位置

Portable 及自部署

对于便携版和手动安装的 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 桌面应用程序，你可以参考下图打开额外模型的配置文件：

或者通过下面的位置打开：

Windows

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

macOS

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

对应的配置文件不应该被改变

​

配置示例

比如，你需要额外让 ComfyUI 识别的模型文件位于下面的文件夹:

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

那么你可以进行如下的配置来让 ComfyUI 识别到你设备上的模型路径

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 才能生效。

下面是完整的原始的配置配置示例:

#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

​

添加额外自定义节点路径

除了添加外部模型之外，你同样可以添加不在 ComfyUI 默认路径下的自定义节点路径

请注意，这并不会改变自定义节点的默认安装路径，只是在启动 ComfyUI 时会增加额外的路径搜索，你仍旧需要在对应的环境中完成自定义节点的依赖的安装，来保证其运行环境的完整性。

下面是一个简单的配置示例（Mac 系统），请根据你的实际情况进行修改，并新增到对应的配置文件中，保存后需要 重启 ComfyUI 才能生效:

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