安装环境:Windows11、Nvidia显卡、硬盘空间>20G

1、安装miniconda

下载地址:https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe

安装完成后添加PATH环境变量:

  • 安装位置\miniconda3

  • 安装位置\miniconda3\Scripts

  • 安装位置\miniconda3\Library\bin

验证安装是否成功

conda -V

输出版本号即表示安装成功

conda 25.5.1

配置镜像源(可选)

# 添加 Anaconda 官方源镜像
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
# 添加 Conda-Forge 镜像(第三方包)
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/

# 全局设置清华镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
# 可选:添加额外镜像源(如阿里云,用于备用)
pip config set global.extra-index-url https://mirrors.aliyun.com/pypi/simple/

# 设置清华镜像为全局默认
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
# 可选:添加备用镜像源(如阿里云)
pip3 config set global.extra-index-url https://mirrors.aliyun.com/pypi/simple/

2、下载ComfyUI

  • 如果已安装git,则git clone仓库地址:https://github.com/comfyanonymous/ComfyUI.git

  • 如果未安装git,则下载压缩包并解压:https://github.com/comfyanonymous/ComfyUI/archive/refs/heads/master.zip

通过上述任意方式获取到ComfyUI安装包之后,先不要运行其中内容。

3、安装CUDAToolKit

查看CUDA Version

nvidia-smi

查看右上角CUDA Version,如:12.9

+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 576.88                 Driver Version: 576.88         CUDA Version: 12.9     |
|-----------------------------------------+------------------------+----------------------+

根据CUDA Version,前往Nvidia官网下载对应版本的CUDAToolkit并安装,注意:CUDAToolkit版本号不得高于CUDA Version

下载地址:https://developer.nvidia.com/cuda-downloads/

验证安装是否成功

conda -V

输出版本号即表示安装成功

nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2024 NVIDIA Corporation
Built on Wed_Oct_30_01:18:48_Pacific_Daylight_Time_2024
Cuda compilation tools, release 12.6, V12.6.85
Build cuda_12.6.r12.6/compiler.35059454_0

4、安装PyTorch&安装ComfyUI依赖包

下载PyTorch:https://pytorch.org/get-started/locally/

根据上一步安装的CUDAToolkit版本选择对应的Compute Platform

注意:Compute Platform不得高于CUDAToolkit版本(注意不是CUDA Version)

复制Run this Command中的bash命令,并采用国内镜像源进行替换,否则国内下载速度很慢!

下面以南京大学镜像为例,截至2025/7/23亲测可用,如果无法使用请寻找其他镜像站代替

https://download.pytorch.org/whl/替换成https://mirrors.nju.edu.cn/pytorch/whl/

#创建conda环境
conda create --name comfyui python=3.12
#切换到conda环境
conda activate comfyui
#安装pytorch(替换成刚才复制的Command,注意替换镜像源,否则速度很慢),例:
pip3 install torch torchvision torchaudio --index-url https://mirrors.nju.edu.cn/pytorch/whl/cu126
#等待安装完成
...(略)...Successfully installed...(略)...
#进入ComfyUI安装包目录
cd /d 你的ComfyUI目录(参考第2步)
#安装依赖
pip install -r ./requirements.txt
#等待安装完成
...(略)...Successfully installed...(略)...

5、运行ComfyUI

在上一步的shell窗口中继续输入,请保持在conda虚拟环境下

#启动ComfyUI
python ./main.py
#等待启动....直到输出To see the GUI go to: web地址即表示启动成功,例:
To see the GUI go to: http://127.0.0.1:8188

打开浏览器访问输出的地址,即可进入ComfyUI,大功告成!(注意shell窗口需要保持开启,关闭shell意味着停止ComfyUI)

下次启动时,通过以下方式即可(也可以制作成bat简化操作)

conda activate comfyui
cd /d 你的ComfyUI目录(参考第2步)
python ./main.py

6、可能遇到的问题&解决方案

'nvidia-smi' 不是内部或外部命令,也不是可运行的程序或批处理文件。

'nvidia-smi' 不是内部或外部命令,也不是可运行的程序或批处理文件。

可能的原因1:未添加nvidia-smi的PATH环境变量。

可能的原因2:N卡驱动未正确安装。

首先尝试更新Nvidia驱动,基本上可以解决此问题(新版驱动的nvidia-smi.exe在System32下)。

如果更新最新驱动后仍然有异常,请尝试添加以下路径到PATH环境变量中(旧版本的驱动使用以下地址):

  • C:\Program Files\NVIDIA Corporation\NVSMI

启动ComfuUI时出现错误:AssertionError: Torch not compiled with CUDA enabled

Traceback (most recent call last):
...(略)...
AssertionError: Torch not compiled with CUDA enabled

可能的原因1:安装的Pytorch版本高于CUDAToolkit,需要重新安装。

可能的原因2:(可能是玄学,未知原因安装到了cpu版本),需要重新安装。

可以通过下面的方式进行检查

#进入python运行模式
python
#输入以下内容
import torch
print(torch.__version__)  #需包含`+cu[版本号]`字样  如果是`+cpu[版本号]`,表示安装到了cpu版本
print(torch.cuda.is_available())  #需返回True  如果返回Flase,则需要检查版本号

检查完毕后,Ctrl+Z 回车退出python模式。

如果有任意一项检查结果不符合预期,先使用以下方式卸载:

pip3 uninstall -y torch torchvision torchaudio

如果是因为版本太高,请参考步骤4重新安装。

如果版本正确,但是安装到了cpu版本,请尝试以下方式:

#尝试安装下cpuonly
conda install cpuonly
#等待安装成功...然后卸载cpuonly
conda uninstall cpuonly
#参考步骤4重新安装