ComfyUI

项目概述

ComfyUI 是一个面向视觉创作的可视化 AI 引擎，采用基于节点图的模块化界面，让创作者在不编写代码的情况下构建可复用的图像、视频、3D 模型与音频生成工作流。原生支持当前主流开源模型（包括 Stable Diffusion 1.5、SDXL、SD3.5、Flux.1/2、Qwen Image、Hunyuan 系列、Wan Video、LTX-Video、CogVideoX、Hunyuan3D 等），并通过合作伙伴节点接入闭源模型。核心功能完全离线运行，可通过 --disable-api-nodes 关闭付费 API 节点以保持本地化。

安装方式

桌面应用与便携版

最简方式是下载官方桌面应用（Windows、macOS）。也可使用 Windows 便携版：分别提供 NVIDIA、AMD、Intel GPU 的独立构建，以及面向老旧显卡的 CUDA 12.6 + Python 3.12 版本。便携包内置 Python 3.13 与 PyTorch CUDA 13.0。

命令行工具

通过 comfy-cli 一键安装：

pip install comfy-cli
comfy install

手动安装

• Python 3.13 兼容性最佳，3.14 部分自定义节点可能异常。
• PyTorch 2.7 为最低支持版本，推荐使用最新版。
• NVIDIA 用户（20 系及以上）需 cu130 及以上：

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

• AMD GPU（Linux）使用 ROCm 7.2 stable 或 nightly 源。
• Intel Arc GPU 使用 xpu 后端 PyTorch。
• Apple Silicon、Ascend NPU、Cambricon MLU、Iluvatar Corex 均提供对应安装流程。

共享模型

通过 extra_model_paths.yaml 配置额外模型搜索路径，便携版中该文件位于 ComfyUI 根目录。

核心特性

• 节点图界面支持图像、视频、音频、3D 与文本工作流的可视化构建。
• 支持子图复用、工作流模板、App Mode 以及本地 API 集成。
• 异步队列调度、部分图重执行、显存/内存智能管理、模型卸载、量化模型支持。
• 加载完整 checkpoint 或独立的扩散模型、VAE、文本编码器、LoRA、ControlNet、适配器、上采样器。
• 内置工具：局部重绘、外扩、参考条件控制、遮罩合成、模型合并、上采样、帧插值、分割、深度估计。
• 工作流以 JSON 保存；可从已生成媒体中恢复完整工作流与随机种子。
• 通过自定义节点扩展功能。

ComfyUI-Manager

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

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

常用参数：--enable-manager-legacy-ui（旧版界面）、--disable-manager-ui（禁用 UI 但保留后台任务）。

运行与配置

启动命令：

python main.py

部分常用配置示例：

• 启用高质量预览：--preview-method taesd，需将 taesd_decoder.pth 等文件放入 models/vae_approx。
• 启用 TLS/SSL：使用 openssl 生成自签名证书后，通过 --tls-keyfile 与 --tls-certfile 启用。
• 使用最新版前端：--front-end-version Comfy-Org/ComfyUI_frontend@latest，也可指定版本号。
• 提示词中 (word:1.2) 调整权重；{a|b|c} 实现动态随机提示；embedding:filename.pt 调用文本反转嵌入。

快捷键速查

• Ctrl + Enter：提交当前工作流到队列
• Ctrl + Shift + Enter：作为首个任务入队
• Ctrl + Alt + Enter：取消当前生成
• Ctrl + S / Ctrl + O：保存/加载工作流
• Ctrl + B：旁路选中节点
• Ctrl + G：编组节点
• Space：按住拖动画布
• .：视图适配（全图或选中节点）
• Q / H：切换队列/历史可见性
• P：固定/取消固定节点
• Ctrl + Shift + LMB + 垂直拖动：画布缩放

macOS 用户可将 Ctrl 替换为 Cmd。

发布周期

核心仓库约每两周发布一个稳定主版本（如 v0.7.0），自 v0.4.0 起使用补丁版本回溯修复。桌面端基于最新稳定核心构建，前端每两周合并入核心仓库一次。稳定标签外的提交可能不稳定，会破坏自定义节点。