按操作系统与动手能力选一种即可,四种方式共用同一套模型目录与工作流格式。
从官方 Release 按显卡与架构选一个 .7z,解压到纯英文路径,双击 run_nvidia_gpu.bat(或对应 bat)即启动,无需装 Python。
下载安装包按向导装好,自动配置依赖与更新,带托盘图标,适合不想碰命令行的用户。
git clone 仓库 → 建 venv → 装对应 PyTorch → pip install -r requirements.txt → python main.py,适合 Linux / macOS 与开发者。
用官方或社区镜像起容器,挂载 models 与 output 目录,适合服务器多卡与团队共用。
127.0.0.1:8188,界面与工作流文件完全通用。解压到 D:\ComfyUI\ 之类的纯英文短路径,
路径里有中文、空格或层级过深,容易在加载 PyTorch 时报错。解压需要预留 10–20GB 空间。
NVIDIA 包双击 run_nvidia_gpu.bat;仅想试跑可用
run_cpu.bat。等控制台打印 To see the GUI go to: http://127.0.0.1:8188,
窗口不要关,它就是本地服务进程。
把 .safetensors 放进
ComfyUI/models/checkpoints,用 Chrome / Edge 打开 127.0.0.1:8188,
在 Load Checkpoint 下拉框选到模型即安装完成。目录表见节点文档。
整合包里到底打包了什么、升级时哪些目录要搬,见便携版专页。
git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
python main.py # 仅 CPU: python main.py --cpu
源码部署要点:Python 建议 3.10 – 3.13,PyTorch 按显卡选对应 CUDA / ROCm / XPU 轮子,
Apple Silicon 走 MPS 后端;装完先运行一次让依赖自检,再打开界面。
低显存设备可加 --lowvram,纯 CPU 调试加 --cpu。
官方文档入口在 docs.comfy.org。
| 平台 | 后端 | 启动参数提示 |
|---|---|---|
| NVIDIA 显卡 | CUDA | 默认即可;驱动旧可加 --lowvram |
| AMD 显卡 | ROCm(Linux)/ 专用便携包(Windows) | 按官方轮子安装对应 PyTorch |
| Intel Arc | XPU | 安装 IPEX 相关依赖后再启动 |
| Apple Silicon | MPS | 用桌面版或源码,无需 CUDA |
| 无独显 | CPU | python main.py --cpu,速度显著下降 |
Docker 方式把 models、output、custom_nodes 三个目录挂到宿主机,
升级镜像时模型不会丢,适合服务器多卡与团队共用。桌面版 v0.9.4 则是标准安装包向导,
自动配置依赖、带托盘图标与更新检查,macOS 用户走这条路最省心。
无论哪种 comfyui安装 方式,模型目录结构与 comfyui工作流 JSON 格式都是一致的,
所以后期从便携版迁到源码部署,只需要把 models 与 user/default/workflows 拷过去。
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 双击 bat 闪退 | 路径含中文/空格、解压不完整、杀毒删了 dll | 换纯英文短路径,重新解压,加白名单 |
| No module named torch | 运行时目录被破坏或选错包 | 重新解压;核对是否用了 ARM64 包 |
| CUDA out of memory | 显存不足或分辨率/批量过大 | 降分辨率、加 --lowvram、换 fp8 权重 |
| 模型下拉框为空 | 权重没放进 checkpoints 目录 | 按目录表放置后点刷新 |
| 8188 打不开 | 服务未启动或端口被占用 | 看控制台是否打印监听地址,必要时指定端口 |
| 界面空白 / 报错 | 浏览器缓存或前端版本不匹配 | 强刷缓存,换 Chrome / Edge,核对版本 |
| 导入工作流一片红 | 缺自定义节点 | Manager 安装缺失节点,见工作流页 |