在本篇我们将介绍安装 ComfyUI 的系统要求, 由于 ComfyUI 的更新频繁,本篇文档未必能够及时更新,请参考ComfyUI中的相关说明。

无论是哪个版本的 ComfyUI,都是运行在一个独立的 Python 环境中。

你可以参考下面的章节来了解不同系统和版本 ComfyUI 的安装方式,在不同版本的安装中我们简单对安装的系统要求进行了说明。

Nvdia 50 系显卡运行要求

如果要使你的 Nvdia 50 系 GPU(Blackwell架构)可以正常运行 ComfyUI,你需要一个针对 CUDA 12.8 或更新版本的 PyTorch, 目前(2025年3月) PyTorch 的稳定版本尚未支持 Blackwell 架构,所以你需要使用夜间构建的版本。

另外对应的相关问题讨论将集中在这里

针对 Windows 的用户

推荐方案: 下载带有 nightly pytorch 2.7 cu128 的独立 ComfyUI Portable 版本:

其他选择: 旧版本 torch 2.6 Windows 包:

手动安装

Windows 和 Linux 用户可以使用以下命令安装 PyTorch nightly 版本:

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

Docker 容器替代方案

你可以尝试由 Nvidia 提供的 PyTorch 容器,这可能会提供更好的性能。

容器地址: https://catalog.ngc.nvidia.com/orgs/nvidia/containers/pytorch

使用方法:

docker run -p 8188:8188 --gpus all -it --rm nvcr.io/nvidia/pytorch:25.01-py3

在Docker容器内部,执行以下命令:

git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
grep -v 'torchaudio\|torchvision' requirements.txt > temp_requirements.txt
pip install -r temp_requirements.txt
python main.py --listen