## 项目概述

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](https://www.comfy.org/download) 下载桌面应用，支持 Windows 和 macOS。

### Windows 便携版

从 [GitHub Releases](https://github.com/comfyanonymous/ComfyUI/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

```bash
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 仓库](https://github.com/Comfy-Org/ComfyUI)
- [官方网站](https://www.comfy.org/)
- [文档](https://docs.comfy.org/)
- [工作流库](https://comfy.org/workflows)
- [Discord](https://comfy.org/discord)
- [Matrix](https://app.element.io/#/room/%23comfyui_space%3Amatrix.org)

## 信息来源和分析时间

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