仓库：https://github.com/comfyanonymous/ComfyUI 官网：https://www.comfy.org/ 许可证：GPL-3.0（以仓库 LICENSE 为准） 运行形态：本地 Web 节点式界面（默认 8188 端口）
1. 项目简介
ComfyUI 是面向视觉专业人士的模块化节点式 AI 创作引擎，用节点图界面控制每个模型、每个参数、每个输出，可生成图像、视频、3D 模型、音频等。原生支持最新开源 SOTA 模型，是消费级本地硬件上优化程度最高的扩散模型推理引擎之一。
1.1 核心信息一览
| 项目 | 内容 |
|---|---|
| 仓库 | comfyanonymous/ComfyUI |
| 定位 | 节点式扩散模型创作引擎 |
| 平台 | Windows / Linux / macOS |
| GPU | NVIDIA / AMD / Intel / Apple Silicon / Ascend |
| Python | 3.13 推荐（3.14 部分自定义节点可能有问题） |
| PyTorch | 2.7 起，推荐最新大版本 |
1.2 适用场景
- 想用节点图精确控制 SD / 扩散模型工作流；
- 本地消费级硬件跑图像 / 视频生成；
- 需要把工作流存成 JSON、接 API 进生产流水线。
1.3 能力边界（官方口径）
- 普通用户推荐用桌面应用；
- 便携版面向 Windows + NVIDIA；
- 新显卡（20 系及以上）需 cu130 及以上 PyTorch。
2. 功能特性
- 节点图界面：模块化、可保存 / 加载工作流 JSON；
- 高效本地执行：异步队列、部分图重算、智能 VRAM/RAM 管理、模型卸载、量化模型；
- 广泛模型支持：完整 checkpoint 或拆分的扩散模型 / VAE / text encoder / LoRA / ControlNet / adapter / upscaler；
- 高比特深度输出：16bit PNG、32bit EXR、10bit AVIF、HDR 视频图像；
- 多形态产出：图像、视频、3D、音频；
- API 端点：可接入生产流水线。
3. 官方界面预览
上图为官方 README 界面截图（README 官方素材）。
4. 官方跳转链接汇总
- 仓库主页：https://github.com/comfyanonymous/ComfyUI
- 官网：https://www.comfy.org/
- 桌面下载：https://www.comfy.org/download
- 云：https://www.comfy.org/cloud
- 工作流库：https://comfy.org/workflows/
- Releases：https://github.com/comfyanonymous/ComfyUI/releases
- Discord：https://discord.com/invite/comfyorg
5. 前置要求与服务器配置
- 推荐用桌面应用（https://www.comfy.org/download）；
- Python 3.13（3.14 自定义节点可能有兼容问题）；
- PyTorch 2.7+，新 NVIDIA 显卡用 cu130 及以上；
- 端口 8188 不被占用。
6. 方式一：桌面应用 / 便携版（推荐）
- 桌面应用：从 https://www.comfy.org/download 下载；
- Windows 便携版（NVIDIA）：https://github.com/comfyanonymous/ComfyUI/releases/latest/download/ComfyUI_windows_portable_nvidia.7z；
- AMD / Intel / 旧 NVIDIA（10 系）有对应便携版。
7. 方式二：源码 / comfy-cli 运行
# comfy-cli
pip install comfy-cli
comfy install
comfy launch源码：
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
pip install -r requirements.txt
python main.pyAMD 显卡：
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.28. 配置项说明
| 配置 | 说明 |
|---|---|
| 模型目录 | models/ 下放 checkpoint / VAE / LoRA / ControlNet |
| 工作流 JSON | 保存 / 加载节点图 |
| VRAM/RAM 管理 | 自动卸载，消费级硬件友好 |
| 量化模型 | 支持加载量化权重 |
9. 常用运维命令
# 启动
python main.py
# 或 comfy-cli
comfy launch
# 看监听地址（默认 8188）
# 浏览器打开 http://localhost:818810. 常见故障排查
- 起不来 / 报错：先更新 NVIDIA 驱动与 PyTorch；
- 新显卡黑屏：确认用了 cu130+ 的 PyTorch；
- 自定义节点装不上：Python 降到 3.13 试；
- 显存不足：利用官方模型卸载 / 量化模型支持。
11. 风险与合规说明
- GPL-3.0 许可；
- 生成内容版权与所用模型许可相关，遵守模型与素材协议；
- GPU 成本由使用者承担；
- 本文为社区部署笔记，命令以官方 README 最新版本为准。