ComfyUI 安装详细流程

系统要求

• Python 3.10 或更高版本
• Git
• 推荐：NVIDIA显卡（需安装 CUDA 11.8）
• 操作系统：Windows 10/11 或 Linux

安装步骤

1. 克隆仓库

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

2. 安装依赖

使用 pip：

pip install -r requirements.txt

（可选）使用 Conda：

conda create -n comfyui python=3.10
conda activate comfyui
pip install -r requirements.txt

3. 模型文件准备

1. 创建模型目录：

   mkdir -p models/checkpoints

2. 将下载的模型（.ckpt 或 .safetensors）放入 models/checkpoints/

运行 ComfyUI

python main.py

常用启动参数：

• --listen：允许局域网访问
• --port 8188：指定端口
• --highvram：高显存模式
• --lowvram：低显存优化

示例：

python main.py --listen --port 9000

浏览器访问

打开 http://localhost:8188（默认端口）或自定义端口地址

可选配置

安装自定义节点

1. 将节点文件放入 custom_nodes/ 目录
2. 重启 ComfyUI

更新 ComfyUI

git pull
pip install -r requirements.txt --upgrade

常见问题解决

1. 依赖安装失败：

   • 确保 Python 版本 ≥3.10
   • 尝试 pip install --upgrade pip setuptools

2. 端口冲突：

   netstat -ano | findstr :8188  # Windows
   lsof -i :8188                # Linux

3. CUDA 错误：

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

4. 无界面显示：

   • 检查 comfy.log 日志文件
   • 确保模型文件已正确放置