课程 2:使用 uv 安装 ComfyUI

课程 2:使用 uv 安装 ComfyUI

1. 本节目标

完成 ComfyUI 的基础安装,包括:

  • 克隆 ComfyUI 项目
  • 创建 uv 虚拟环境
  • 安装 PyTorch CUDA 版本
  • 安装 ComfyUI 依赖
  • 启动并验证 ComfyUI

2. 前置条件

开始前确认 WSL 中能看到 NVIDIA GPU:

bash 复制代码
nvidia-smi

如果 nvidia-smi 不可用,需要先处理 Windows NVIDIA 驱动或 WSL GPU 支持问题。

3. 克隆 ComfyUI

推荐项目路径:

bash 复制代码
/home/wangjian/project

执行:

bash 复制代码
cd /home/wangjian/project
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

4. 创建 uv 虚拟环境

推荐 Python 3.12:

bash 复制代码
uv venv --python 3.12
source .venv/bin/activate

验证 Python 路径:

bash 复制代码
which python

理想输出:

text 复制代码
/home/wangjian/project/ComfyUI/.venv/bin/python

5. 安装 PyTorch CUDA 版本

本次按 CUDA 12.1 wheel 路线安装:

bash 复制代码
uv pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121

如果需要固定版本,可使用:

bash 复制代码
uv pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu121

6. 验证 PyTorch CUDA

执行:

bash 复制代码
uv run python -c "import torch; print(torch.__version__); print(torch.cuda.is_available()); print(torch.version.cuda)"

正常应看到:

text 复制代码
True

如果返回 False,说明 PyTorch 没有正确使用 CUDA,需要优先处理 PyTorch 安装或 NVIDIA 驱动问题。

7. 安装 ComfyUI 依赖

在 ComfyUI 根目录执行:

bash 复制代码
uv pip install -r requirements.txt

8. 启动 ComfyUI

bash 复制代码
cd /home/wangjian/project/ComfyUI
source .venv/bin/activate
uv run python main.py

浏览器访问:

text 复制代码
http://127.0.0.1:8188

9. 成功判断

看到 ComfyUI 页面正常打开,即基础安装成功。

如果页面打不开,先检查终端是否报错。如果终端正常启动但浏览器打不开,检查端口和地址:

text 复制代码
127.0.0.1:8188

10. 注意事项

注意 1:以后都在 ComfyUI 根目录启动

推荐固定使用:

bash 复制代码
cd /home/wangjian/project/ComfyUI
source .venv/bin/activate
uv run python main.py

注意 2:更新后重新安装 requirements

更新 ComfyUI 后建议执行:

bash 复制代码
git pull
uv pip install -r requirements.txt

注意 3:模型文件不是放在项目根目录

模型需要放在 models/ 下对应子目录。具体规则见课程 4。

11. 本节结论

本节完成了 ComfyUI 的基础运行环境。

此时 ComfyUI 能打开,但还不能直接使用 GGUF 视频模型,需要继续安装插件和下载模型。

相关推荐
Thanks_ks几秒前
AI Agent 开发入门:用 Function Calling 让大模型学会 “动手干活”,附订单查询机器人实战
python·ai·大模型·openai·agent·通义千问·mcp
专注仿真22 分钟前
智能体训练之模仿学习:GAIL 算法详解与实战
python·算法·仿真·多智能体强化学习·afsim智能体训练
databook1 小时前
处理一批 PDF,怎么算真的处理完了
后端·python
承渊政道3 小时前
【Python编程快速上手—让繁琐工作自动化】(列表:把数据排成队,从下标取值到深拷贝)
开发语言·python·pycharm·自动化·列表
大胖爱学习_MJ3 小时前
Agent 如何安全地拿数据库密码?基于 HashiCorp Vault 的动态凭证下发
经验分享·python
syso_稻草人4 小时前
qwen-image-2.1 高清放大拆解:Qwen21LatentUpscale 潜空间 2x + denoise 0.35 修细节,12 组场景实测
人工智能·stable diffusion·prompt·comfyui·qwen-image2.1
tryCbest4 小时前
Python 爬虫从入门到实战(一):基础篇——从零写出第一个爬虫
开发语言·爬虫·python
无小道4 小时前
Python语句的特色
python·语句
2601_967980115 小时前
python pytest如何编写测试
python·测试用例·pytest·函数·assert
2601_967980116 小时前
Python中heapq模块的各种用法实例
数据结构·python·算法·应用实例·heapq模块