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

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

创建一个虚拟环境(避免污染系统级 Python 环境)
克隆 ComfyUI 代码仓库
安装依赖
启动 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
Linux
MacOS

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

git clone git@github.com:comfyanonymous/ComfyUI.git

安装GPU 及 ComfyUI 依赖

安装 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) 兼容的模型。要开始使用，请确保您的环境满足安装页面上列出的先决条件。分步指南：

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

Cambricon MLUs

适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。分步指南：

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

Iluvatar Corex

适用于与 Iluvatar Extension for PyTorch 兼容的模型。分步指南：

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

安装 ComfyUI 依赖

cd ComfyUI
pip install -r requirements.txt

启动 ComfyUI

cd ComfyUI
python main.py

如何更新 ComfyUI

拉取最新代码

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

cd <安装路径>/ComfyUI
git pull

安装依赖

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

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

    pip install -r requirements.txt

添加外部模型路径

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

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

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

不同 ComfyUI 版本配置文件位置

Portable 及自部署
ComfyUI Desktop

对于便携版和手动安装的 ComfyUI版本，你可以在 ComfyUI 的根目录下找到 extra_model_paths.yaml.example 的示例文件

ComfyUI/extra_model_paths.yaml.example

复制并重命名为 extra_model_paths.yaml 来使用, 并保持在 ComfyUI 的根目录下, 路径应该是 ComfyUI/extra_model_paths.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

开始使用

基础概念

界面指南

教程示例

故障排除

社区

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

（可选）创建虚拟环境

克隆代码仓库

安装GPU 及 ComfyUI 依赖

如何更新 ComfyUI

添加外部模型路径

不同 ComfyUI 版本配置文件位置

配置示例

添加额外自定义节点路径

开始使用

基础概念

界面指南

教程示例

故障排除

社区

​（可选）创建虚拟环境

​克隆代码仓库

​安装GPU 及 ComfyUI 依赖

​如何更新 ComfyUI

​添加外部模型路径

​不同 ComfyUI 版本配置文件位置

​配置示例

​添加额外自定义节点路径

（可选）创建虚拟环境

克隆代码仓库

安装GPU 及 ComfyUI 依赖

如何更新 ComfyUI

添加外部模型路径

不同 ComfyUI 版本配置文件位置

配置示例

添加额外自定义节点路径