课程 2：使用 uv 安装 ComfyUI

课程 2：使用 uv 安装 ComfyUI

1. 本节目标

完成 ComfyUI 的基础安装，包括：

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

2. 前置条件

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

nvidia-smi

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

3. 克隆 ComfyUI

推荐项目路径：

/home/wangjian/project

执行：

cd /home/wangjian/project
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

4. 创建 uv 虚拟环境

推荐 Python 3.12：

uv venv --python 3.12
source .venv/bin/activate

验证 Python 路径：

which python

理想输出：

/home/wangjian/project/ComfyUI/.venv/bin/python

5. 安装 PyTorch CUDA 版本

本次按 CUDA 12.1 wheel 路线安装：

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

如果需要固定版本，可使用：

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

执行：

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

正常应看到：

True

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

7. 安装 ComfyUI 依赖

在 ComfyUI 根目录执行：

uv pip install -r requirements.txt

8. 启动 ComfyUI

cd /home/wangjian/project/ComfyUI
source .venv/bin/activate
uv run python main.py

浏览器访问：

http://127.0.0.1:8188

9. 成功判断

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

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

127.0.0.1:8188

10. 注意事项

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

推荐固定使用：

cd /home/wangjian/project/ComfyUI
source .venv/bin/activate
uv run python main.py

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

更新 ComfyUI 后建议执行：

git pull
uv pip install -r requirements.txt

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

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

11. 本节结论

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

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