ComfyUI 安装与启动

以 Windows + NVIDIA 为例；版本与脚本会更新，以官方仓库 README 为准。

方式 A：官方便携 / 发布包（入门）

1. 从 GitHub Releases 或官方说明下载 Windows 包
2. 解压到非空格路径，例如：D:\AI\ComfyUI
3. 双击启动脚本（常见如 run_nvidia_gpu.bat）
4. 浏览器打开终端提示的地址，多为：

http://127.0.0.1:8188

方式 B：Git 克隆 + 自建 venv（可更新）

cd /d D:\AI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

python -m venv venv
venv\Scripts\activate

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
pip install -r requirements.txt

python main.py

CUDA 版本

cu124 需与本机驱动匹配。驱动过旧会装不上或运行报错，先升级 NVIDIA 驱动。

首次启动检查

检查	期望
控制台无 Python 栈崩溃	正常
浏览器能开 8188	UI 出来
models/checkpoints 有模型	才能文生图（空则只有界面）

常用启动参数

# 监听所有网卡（局域网手机访问，注意安全）
python main.py --listen 0.0.0.0 --port 8188

# 显存偏紧时可尝试（以当前 CLI help 为准）
python main.py --lowvram
python main.py --novram

python main.py --help

目录建议

D:\AI\ComfyUI\
  models\
    checkpoints\     # 主模型 .safetensors
    loras\
    vae\
    controlnet\
    clip\
    ...
  input\             # 上传图
  output\            # 出图
  custom_nodes\      # 第三方节点
  user\              # 用户数据/工作流（版本可能不同）

更新

cd /d D:\AI\ComfyUI
git pull
venv\Scripts\activate
pip install -r requirements.txt

第三方节点在各自 custom_nodes/某插件 下 git pull，并看其 README 是否要额外 pip install。

验收

• [ ] 能打开 Web UI
• [ ] 至少放入 1 个 checkpoint
• [ ] 默认工作流能出一张图