Windows 下 ComfyUI + Comfy CLI + PyTorch（CUDA）完整源码安装教程

✅源码下载以及Python环境安装

1. 源码地址,去到源码地址下载源码开始构建安装

GitHub - comfyanonymous/ComfyUI: The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.

2. 执行 pip install comfy-cli 发现如下错误,表示没有安装python环境

pip install comfy-cli

3. 下载python,地址如下

https://www.python.org/downloads/windows/

下载版本建议,所以我选择的是3.12.9版本

ComfyUI CLI 使用的 typer 和 annotationlib 等库

• 在类型注解处理上使用了 list[str] 或 Optional[list[str]] 语法
• 这些语法在 Python 3.9–3.13 支持良好,所以我选择的是3.12.9
• Python 3.14 对这些注解的解析方式有变动，导致 TypeError: 'function' object is not subscriptable

4. 安装python

5. 查看pip版本

pip --version  

6. 安装comfy-cli脚手架

pip install comfy-cli

7. 安装comfy

comfy install 

这条输出说明：

• Comfy CLI 安装已经成功可用了；
• 可以运行 comfy install 命令工作正常；
• 并且检测到 ComfyUI 已经安装在 **D:\code\ComfyUI** 路径下，所以没有重新下载。

当前状态总结：

项目	状态
Python 环境	✅ 正常工作（能运行 comfy）
pip	✅ 可用
comfy-cli	✅ 已安装并运行成功
ComfyUI	✅ 已正确安装在 D:\code\ComfyUI

---

8. 安装comfy-ui所需依赖

pip install -r requirements.txt  

👉PyTorch + CUDA 匹配问题(可选,如果有问题)

启动 comfy

comfy launch

发现报错

• OSError: [WinError 1114] 动态链接库(DLL)初始化例程失败 是 PyTorch + NVIDIA GPU 在 Windows 上的常见问题，通常和 显卡驱动 / CUDA / 电源管理设置 有关。

解决思路:

• 正确的 PyTorch 版本
• 正确的 CUDA 版本
• 足够新的 NVIDIA 显卡驱动

1️⃣ 排查原因

1. GPU 驱动版本太旧或不匹配 CUDA
   • PyTorch CUDA 版本和驱动必须兼容。
   • 之前安装的是 RTX 3060 + 驱动 576.02 → 可以用 CUDA 12.1。
2. PyTorch 安装不兼容
   • 如果安装了 CPU 版本或与 CUDA 版本不匹配的版本，会报 DLL 错误。

2️⃣ 解决方案

✅ 步骤 1：确认 NVIDIA 驱动

在 PowerShell 运行：

nvidia-smi

• 检查 Driver Version 是否 ≥ 531.41（对应 CUDA 12.1）
• 如果低于此版本，请去 NVIDIA 官网 更新驱动。

• 我的 GPU 驱动和 CUDA 信息如下：
  • GPU：RTX 3060
  • Driver Version：576.02 ✅
  • CUDA Version：12.9

这意味着：

1. 驱动足够新，完全支持 PyTorch CUDA 12.x。
2. DLL 错误不是因为驱动过旧，而可能是 PyTorch 安装或系统电源管理设置 导致的。

✅ 步骤 2：重新安装 PyTorch（CUDA 12.1）

1. 先卸载旧版本：

pip uninstall torch torchvision torchaudio -y

2. 安装与 CUDA 12.1/12.x 兼容的 PyTorch：

pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1 --index-url https://download.pytorch.org/whl/cu121

3. 检查安装和 CUDA 是否可用：

python -c "import torch; print(torch.__version__, torch.cuda.is_available(), torch.version.cuda)"

4. 启动confyui

 comfy launch

发现控制台打印如下内容,表示启动成功,可以访问控制台

5. 访问控制台
   

📥 下载模型（必须，否则无法生成图）

ComfyUI 不自带模型，需要自己下载放到：

ComfyUI\models\

常见模型结构：

models/checkpoints/xxxx.safetensors     # 主模型（SD1.5 / SDXL）
models/vae/xxxxx.vae                    # VAE 可选
models/controlnet/xxxx.pth              # ControlNet
models/clip/xxxx.pt                     # Clip 模型

推荐两个来源：

• CivitAI
• Hugging Face