ComfyUI

ComfyUI：模块化的 AI 内容创作引擎

ComfyUI 是一个面向视觉创作者的生成式 AI 引擎，通过可视化节点图让用户精确控制模型、参数与输出。它原生支持最新开源模型，并在消费级硬件上提供高度优化的扩散模型推理能力。结合异步权重流式加载技术，最少 4GB 显存加 8GB 内存即可运行较大的开源模型。它在 Windows、Linux 和 macOS 上均可使用，既可通过桌面应用本地运行，也可使用便携版或部署在云端。

核心特性

• 可视化节点图：无需编写代码即可搭建并复用图像、视频、音频、3D 与文本工作流。
• 可复用子图与 App Mode：可将复杂工作流封装为简洁界面，并提供本地 API 接入生产管线。
• 高效本地执行：支持异步队列、局部图重算、智能显存/内存管理、模型卸载与量化模型。
• 广泛的模型支持：涵盖 SD 1.5、SDXL、SD3.5、Flux.1/2、Qwen Image、Wan 2.x、HunyuanVideo、CogVideoX、Hunyuan3D、SAM 3、Gemma 3/4、Qwen3-VL 等图像、视频、音频、3D 与文本模型。
• 加载灵活的模型组件：支持完整 checkpoint 或独立加载扩散模型、VAE、文本编码器、LoRA、ControlNet、适配器与放大器。
• 内置工具：包含局部重绘、外扩扩展、参考条件、蒙版合成、模型融合、超分、帧插值、分割、深度估计等。
• 可扩展性：支持自定义节点扩展，并通过 extra_model_paths.yaml.example 配置额外模型目录。
• 高比特与 HDR 媒体：支持 16 位 PNG、32 位 EXR、10 位 AVIF，以及 HDR 视频/图像格式。
• 离线运行：核心默认不联网，可通过 --offline 彻底禁用 API 节点，或通过 --disable-partner-nodes 仅关闭 API 节点。

快捷键速查

操作	按键
排队生成	Ctrl+Enter
优先排队	Ctrl+Shift+Enter
取消生成	Ctrl+Alt+Enter
保存/加载工作流	Ctrl+S / Ctrl+O
撤销/重做	Ctrl+Z / Ctrl+Y
缩放视图	Alt++ / Alt+-
切换队列/历史可见性	Q / H
适应所选内容	.
分组节点	Ctrl+G
绕过所选节点	Ctrl+B

macOS 可将 Ctrl 替换为 Cmd。

安装方式

桌面应用

适用于 Windows 与 macOS，是新手最便捷的途径。

便携版（Windows）

下载对应 7z 包并解压即可运行，提供 NVIDIA、AMD、Intel GPU 版本，以及面向老旧 NVIDIA 显卡的 CUDA 12.6 + Python 3.12 版本。

comfy-cli

pip install comfy-cli
comfy install

手动安装（Windows、Linux）

推荐 Python 3.13，PyTorch 建议使用最新版；NVIDIA 20 系及以上需 cu130 或更高版本。克隆仓库后将模型放入 models/checkpoints，VAE 放入 models/vae，最后在 ComfyUI 目录下执行：

pip install -r requirements.txt
python main.py

各 GPU 厂商的 PyTorch 安装命令示例：

# NVIDIA
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# AMD (Linux)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# AMD (Windows, ROCm 10.0, PyTorch 2.13)
pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ "torch[device-all]==2.13.0+rocm10.0.0" "torchvision[device-all]==0.28.0+rocm10.0.0" "torchaudio==2.11.0.2+rocm10.0.0"

# Intel XPU
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

平台还兼容 Apple Silicon、Ascend NPU、Cambricon MLU 与 Iluvatar Corex，详见官方说明。

ComfyUI-Manager

用于安装、更新与管理自定义节点的扩展：

pip install -r manager_requirements.txt
python main.py --enable-manager

常用参数：--enable-manager-legacy-ui 使用旧版界面，--disable-manager-ui 仅保留后台功能。

使用提示

• 仅执行图中满足全部正确输入的节点；若重复提交相同图，只执行首次。
• 默认预览分辨率为低质量潜空间图；将 TAESD 解码器放入 models/vae_approx 后，可使用 --preview-method taesd 启用高质量预览。
• 提示词支持 (word:1.2) 强调语法与 {a|b|c} 动态提示（C 风格注释亦可使用）。
• 文本反演嵌入文件放入 models/embeddings，在 CLIPTextEncode 节点中以 embedding:filename.pt 引用。
• 将生成的 PNG 拖入网页即可还原完整工作流与种子信息。
• 启用 TLS/SSL：--tls-keyfile key.pem --tls-certfile cert.pem。

前端开发

2024 年 8 月 15 日起，前端迁移至独立仓库 ComfyUI Frontend，编译后的 JS 包作为 comfyui-frontend-package 依赖安装。可通过 --front-end-version Comfy-Org/ComfyUI_frontend@latest 切换至每日构建，或固定到特定版本号。

发布流程

ComfyUI 主仓库大约每两周发布一个稳定主版本（如 v0.7.0），自 v0.4.0 起补丁版本用于当前稳定版的回溯修复；前端每两周合入主仓库一次；桌面端基于最新稳定核心构建。