手动安装 ComfyUI（Windows、macOS、Linux）

在 Windows、macOS 或 Linux 上手动安装 ComfyUI：创建虚拟环境、克隆仓库、安装 GPU 依赖并启动应用。

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

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

你也可以参考 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 https://github.com/Comfy-Org/ComfyUI.git

​

安装GPU 及 ComfyUI 依赖

1. 安装 GPU 依赖

   安装 GPU 依赖

   Nvidia

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

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

   安装 Nightly 版本

   安装 Nightly 版本（可能存在一定风险）

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

   AMD

   Linux 上安装 ROCm 7.2 版本的 PyTorch：

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

   或者，您可以安装 PyTorch 的 nightly 版本（ROCm 7.2）。

   安装 Nightly 版本

   安装 Nightly 版本（可能存在一定风险）

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

   Windows 上请使用 AMD 的多架构 PyTorch 软件包（ROCm 10.0）。device-* 附加项会自动安装对应 GPU 的内核和匹配的 ROCm 运行时，无需单独安装 HIP SDK。请使用 Windows 11、最新的 AMD 显卡驱动和 64 位 Python 3.13。

   下面的安装命令使用 device-all 安装所有受支持 GPU 的内核。如需减少下载体积和磁盘占用，可以选择将 两处 device-all 替换为您 GPU 对应的目标：

   GPU	设备附加项
   RX 9070 / XT、Radeon AI PRO R9700	device-gfx1201
   RX 9060 / XT	device-gfx1200
   RX 7900 XT / XTX	device-gfx1100
   RX 7700 XT / 7800 XT	device-gfx1101
   RX 7600 / XT	device-gfx1102
   Ryzen AI Max / Max+（Strix Halo）	device-gfx1151

   此表仅列出部分示例。表中未列出的 GPU 仍可能受支持：支持的架构包括 RDNA 2、RDNA 3、RDNA 3.5 和 RDNA 4。保留 device-all 可安装所有受支持目标的内核。其他型号请参阅 AMD 的 GPU 目标表和 ROCm 兼容性矩阵。

   pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ "torch[device-all]==2.13.0+rocm10.0.0" "torchvision[device-all]==0.28.0+rocm10.0.0" "torchaudio==2.11.0.2+rocm10.0.0"
   

   Mac ARM Silicon

   conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly
   
2. 安装 ComfyUI 依赖

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

   启动 ComfyUI

   cd ComfyUI
   python main.py
   

   运行 python main.py --help 查看内置帮助，或参阅启动参数参考获取完整命令行选项列表。

如需高级服务器配置（自定义端口、局域网访问、VRAM 模式等），请参阅启动参数参考。

​

如何更新 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

你也可以在 这里 找到配置示例文件

Comfy Desktop

如果你使用的是 ComfyUI 桌面应用程序，点击桌面应用顶部的胶囊菜单，打开 存储（Storage） 标签页，在其中添加模型目录。胶囊菜单仅桌面应用内存在，浏览器访问的 Web 版没有此项

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

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

​

常见问题

Docker： ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 Docker Hub 搜索社区维护的镜像，但这些均非 ComfyUI 官方镜像，也不受 ComfyUI 团队支持，请自行评估风险后使用。

​

如何停止/退出 ComfyUI

在运行 ComfyUI 的终端窗口中按 Ctrl+C，或直接关闭终端窗口。