Comfy-Org / ComfyUI

Comfy-Org/ComfyUI

open_in_new前往仓库

ComfyUI 是一个模块化的 AI 内容创作引擎，提供可视化节点图界面，支持图像、视频、3D 模型和音频生成，兼容多种开源模型，可本地部署或云端使用。

项目概览

项目概述

ComfyUI 是一个功能强大且模块化的 AI 内容创作引擎，提供可视化节点图界面，使用户能够通过拖拽节点构建和复用图像、视频、音频、3D 模型和文本生成工作流。它原生支持最新的开源模型，并可通过合作伙伴节点访问部分闭源模型。ComfyUI 支持本地部署（Windows、Linux、macOS）和云端使用，并提供 API 接口以便集成到生产流程中。

核心功能

  • 可视化节点图界面：无需编写代码即可构建和复用图像、视频、音频、3D 和文本工作流。
  • 广泛的模型支持：原生支持 Stable Diffusion 1.5、SDXL、SD3.5、Flux.1、Flux.2、Qwen Image、Hunyuan Image 2.1、Wan 2.1/2.2、LTX-Video、HunyuanVideo、MiniMax H3、ACE-Step、Hunyuan3D 等众多模型。
  • 高效本地执行：异步队列、部分图重执行、智能 VRAM/RAM 管理、模型卸载和量化模型支持。
  • 内置工具：支持 inpainting、outpainting、参考条件、遮罩合成、模型合并、放大、帧插值、分割、深度估计和媒体处理。
  • 工作流管理：以 JSON 格式保存和加载工作流，可从生成的媒体中恢复完整工作流和种子。
  • 离线运行：核心功能完全离线，除非用户请求，否则不下载任何内容。
  • 可扩展性：支持自定义节点，可通过 ComfyUI-Manager 管理。
  • API 集成：提供本地 API 端点，便于将工作流集成到应用程序中。

适用与不适用场景

适用场景：

  • 视觉专业人士和创作者需要精细控制模型、参数和输出。
  • 需要生成图像、视频、3D 模型、音频等多种媒体内容。
  • 希望使用最新开源模型进行实验和创作。
  • 需要将 AI 生成流程集成到生产管道中。
  • 偏好本地部署以保护数据隐私或避免云成本。

不适用场景：

  • 对编程不熟悉且希望开箱即用的用户（建议使用桌面应用或云端服务）。
  • 需要闭源模型（如 GPT-4）的特定功能，除非通过合作伙伴节点。
  • 硬件资源有限且无法满足模型运行要求的环境。

技术架构与依赖

  • 编程语言：Python
  • 主要依赖：PyTorch（支持 CUDA、ROCm、XPU、Apple Silicon、Ascend NPU、Cambricon MLU、Iluvatar Corex）
  • 前端：独立仓库 ComfyUI Frontend，编译后的 JS 文件通过 pypi 包安装。
  • 核心仓库：ComfyUI Core（本仓库），负责后端逻辑和模型执行。
  • 桌面应用：Comfy Desktop，基于核心版本构建。
  • 许可证：GPL-3.0

安装与快速开始

桌面应用（推荐）

从 Comfy.org 下载桌面应用，支持 Windows 和 macOS。

Windows 便携版

从 GitHub Releases 下载便携版压缩包，解压后运行。提供 NVIDIA、AMD、Intel GPU 版本。

手动安装（Windows、Linux）

  1. 克隆仓库：git clone https://github.com/Comfy-Org/ComfyUI.git
  2. 安装 PyTorch（根据 GPU 类型选择命令，例如 NVIDIA：pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130）
  3. 安装依赖：pip install -r requirements.txt
  4. 将模型文件放入 models/checkpoints 等对应目录。
  5. 运行：python main.py

使用 comfy-cli

pip install comfy-cli
comfy install

典型使用方法

  1. 启动 ComfyUI 后，在浏览器中打开界面。
  2. 通过拖拽节点构建工作流，或加载现有工作流模板。
  3. 配置模型、提示词和参数。
  4. 点击“Queue”或按 Ctrl+Enter 执行生成。
  5. 保存工作流为 JSON 文件，或从生成的 PNG 中恢复工作流。

配置与部署要点

  • 模型路径：可通过 extra_model_paths.yaml 配置文件指定额外的模型搜索路径。
  • 预览质量：使用 --preview-method auto 或 --preview-method taesd 启用高质量预览。
  • TLS/SSL：生成自签名证书并使用 --tls-keyfile 和 --tls-certfile 启用 HTTPS。
  • ComfyUI-Manager：使用 --enable-manager 启用扩展管理器。
  • 前端版本：可通过 --front-end-version 指定前端版本。
  • 离线模式：使用 --disable-api-nodes 禁用付费 API 节点，确保完全离线。

限制、风险与许可证

  • 许可证：GPL-3.0，使用或分发时需遵守相关条款。
  • 硬件要求：运行大型模型需要较高配置的 GPU 和内存。
  • 稳定性：非稳定版本的提交可能不稳定，可能破坏自定义节点。
  • 模型合规性：使用模型时需遵守各模型的许可证和条款。
  • 安全风险：自定义节点可能带来安全风险，建议从可信来源安装。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、CONTRIBUTING.md、最新 Release 信息。
  • 分析时间：2026年8月13日（基于最新 Release 日期）。