ComfyUI 的安装

有几种方法可以在本地环境中运行 ComfyUI：

便携版灵活且稳定，无论谁来安装都能创建出相似的环境，因此本站将以使用便携版为前提进行解说。

此外，我们也将在这里介绍 ComfyUI Manager 的安装。

这是一个能简化 ComfyUI 管理（如安装自定义节点）的工具。

使用便携版进行安装

便携版打包了 Python、PyTorch 和 CUDA 环境，只需解压即可运行。

1. 下载

访问 ComfyUI 的 GitHub 发布页面 并选择适合你 GPU 的文件。

GPU 类型 文件名 (例) 备注
NVIDIA GPU ComfyUI_windows_portable_nvidia.7z 驱动程序足够新的环境下，请首先选择此版本。如果启动失败，请更新 GPU 驱动，或使用下方的旧驱动版。
NVIDIA GPU (稳定/旧版环境) cu126/cu128 不想更新驱动，或者标准版启动后立即退出的情况下使用。
AMD GPU ComfyUI_windows_portable_amd.7z 面向 AMD 用户。

2. 解压与启动

  1. 右键点击下载的 7z 文件，选择“提取到”进行解压。
  2. 双击解压文件夹中的 run_nvidia_gpu.bat 启动。
  3. 首次启动时环境配置需要一些时间。如果浏览器自动打开，即表示成功。

3. 安装 ComfyUI Manager

  1. 打开 ComfyUI_windows_portable 文件夹，在文件夹内右键点击，选择 在终端中打开。

  2. 在打开的窗口中输入以下命令，然后按 Enter。

    .\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt

    这样会安装 Manager 所需的库。

    不过，仅这样操作还不会在画面中显示 Manager。接下来需要给启动用的 .bat 文件追加命令行参数。

  3. 右键点击 run_nvidia_gpu.bat，选择 编辑。

  4. 在执行 main.py 的那一行末尾，追加 --enable-manager。

    .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager

  5. 如果想使用旧版 ComfyUI Manager，也追加 --enable-manager-legacy-ui。

    .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager --enable-manager-legacy-ui

桌面版

这是面向 Windows 的安装程序形式。预装了 ComfyUI Manager 等，提供了稳定的运行环境，但也因此稍微多了一些限制。

下载

  1. 从 ComfyUI Desktop 的 GitHub 页面 下载 ComfyUI Setup.exe。
  2. 运行程序，选择安装位置和 GPU 设置。

ComfyUI Manager 默认已经搭载。

手动安装 (Windows, Linux)

使用标准的 git clone 和 pip 进行安装的方法。

关于 Python 版本

  • 推荐 Python 3.13。
  • 如果自定义节点的依赖关系出现问题，请尝试 3.12。

1. 安装

  1. 克隆仓库，并移动到 ComfyUI 文件夹。

    git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

  2. 创建并激活虚拟环境。

    Windows 的情况:

    python -m venv venv
venv\Scripts\activate

    Linux/macOS 的情况:

    python -m venv venv
. venv/bin/activate

2. 安装 PyTorch (NVIDIA)

  1. 通常安装稳定版 (Stable)。

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

  2. 如果想使用 Nightly 版，请执行下面的命令。

    它有可能提升性能，但通常使用稳定版即可。

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

3. 安装依赖

  1. 安装依赖。

    pip install -r requirements.txt

4. 安装 ComfyUI Manager

  1. 安装 ComfyUI Manager 所需的库。

    pip install -r manager_requirements.txt

  2. 启动 ComfyUI 时，追加 --enable-manager。

    python main.py --enable-manager

  3. 如果想使用旧版 ComfyUI Manager，也追加 --enable-manager-legacy-ui。

    python main.py --enable-manager --enable-manager-legacy-ui

关于一键安装包

像 Pinokio 或 Stability Matrix 这样的一键安装包确实很方便，可以轻松引入复杂的功能。

然而，中间涉及的要素越多，故障也就越多……当出现问题时，很难查明原因，最终往往超出初学者的处理能力。

包括便携版在内，ComfyUI 的安装并不难，因此建议简单地只使用官方提供的手段进行安装。

参考文献