Comfy-Org/ComfyUI

ComfyUI 允许你通过基于图形/节点/流程图的界面设计和执行高级 Stable Diffusion 流程。支持 Windows、Linux 和 macOS。 ## 开始使用 #### [桌面应用程序](https://www.comfy.org/download) - 最简单的入门方式。 - 支持 Windows 和 macOS。 #### [Windows 便携版](#installing) - 获取最新的提交且完全便携。 - 支持 Windows。 #### [手动安装](#manual-install-windows-linux) 支持所有操作系统和 GPU 类型（NVIDIA, AMD, Intel, Apple Silicon, Ascend）。 ## [示例](https://comfyanonymous.github.io/ComfyUI_examples/) 通过[示例工作流](https://comfyanonymous.github.io/ComfyUI_examples/)了解 ComfyUI 能做什么。 ## 功能 - 节点/图形/流程图界面，无需编写代码即可实验和创建复杂的 Stable Diffusion 工作流。 - 图像模型 - SD1.x, SD2.x ([unCLIP](https://comfyanonymous.github.io/ComfyUI_examples/unclip/)) - [SDXL](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/), [SDXL Turbo](https://comfyanonymous.github.io/ComfyUI_examples/sdturbo/) - [Stable Cascade](https://comfyanonymous.github.io/ComfyUI_examples/stable_cascade/) - [SD3 and SD3.5](https://comfyanonymous.github.io/ComfyUI_examples/sd3/) - Pixart Alpha and Sigma - [AuraFlow](https://comfyanonymous.github.io/ComfyUI_examples/aura_flow/) - [HunyuanDiT](https://comfyanonymous.github.io/ComfyUI_examples/hunyuan_dit/) - [Flux](https://comfyanonymous.github.io/ComfyUI_examples/flux/) - [Lumina Image 2.0](https://comfyanonymous.github.io/ComfyUI_examples/lumina2/) - [HiDream](https://comfyanonymous.github.io/ComfyUI_examples/hidream/) - [Qwen Image](https://comfyanonymous.github.io/ComfyUI_examples/qwen_image/) - [Hunyuan Image 2.1](https://comfyanonymous.github.io/ComfyUI_examples/hunyuan_image/) - [Flux 2](https://comfyanonymous.github.io/ComfyUI_examples/flux2/) - [Z Image](https://comfyanonymous.github.io/ComfyUI_examples/z_image/) - 图像编辑模型 - [Omnigen 2](https://comfyanonymous.github.io/ComfyUI_examples/omnigen/) - [Flux Kontext](https://comfyanonymous.github.io/ComfyUI_examples/flux/#flux-kontext-image-editing-model) - [HiDream E1.1](https://comfyanonymous.github.io/ComfyUI_examples/hidream/#hidream-e11) - [Qwen Image Edit](https://comfyanonymous.github.io/ComfyUI_examples/qwen_image/#edit-model) - 视频模型 - [Stable Video Diffusion](https://comfyanonymous.github.io/ComfyUI_examples/video/) - [Mochi](https://comfyanonymous.github.io/ComfyUI_examples/mochi/) - [LTX-Video](https://comfyanonymous.github.io/ComfyUI_examples/ltxv/) - [Hunyuan Video](https://comfyanonymous.github.io/ComfyUI_examples/hunyuan_video/) - [Wan 2.1](https://comfyanonymous.github.io/ComfyUI_examples/wan/) - [Wan 2.2](https://comfyanonymous.github.io/ComfyUI_examples/wan22/) - [Hunyuan Video 1.5](https://docs.comfy.org/tutorials/video/hunyuan/hunyuan-video-1-5) - 音频模型 - [Stable Audio](https://comfyanonymous.github.io/ComfyUI_examples/audio/) - [ACE Step](https://comfyanonymous.github.io/ComfyUI_examples/audio/) - 3D 模型 - [Hunyuan3D 2.0](https://docs.comfy.org/tutorials/3d/hunyuan3D-2) - 异步队列系统 - 许多优化：仅重新执行两次运行之间发生变化的工作流部分。 - 智能内存管理：通过智能卸载，可以在显存（VRAM）低至 1GB 的 GPU 上自动运行大型模型。 - 即使没有 GPU 也能工作，使用：`--cpu`（较慢） - 可以加载 ckpt 和 safetensors：包括整合版的 checkpoints 或独立的扩散模型、VAE 和 CLIP 模型。 - 安全加载 ckpt, pt, pth 等文件。 - Embeddings/Textual inversion - [Loras (regular, locon 和 loha)](https://comfyanonymous.github.io/ComfyUI_examples/lora/) - [Hypernetworks](https://comfyanonymous.github.io/ComfyUI_examples/hypernetworks/) - 从生成的 PNG, WebP 和 FLAC 文件中加载完整工作流（包含种子）。 - 将工作流保存/加载为 Json 文件。 - 节点界面可用于创建复杂的工作流，例如[Hires fix](https://comfyanonymous.github.io/ComfyUI_examples/2_pass_txt2img/)或更高级的工作流。 - [区域构图](https://comfyanonymous.github.io/ComfyUI_examples/area_composition/) - [重绘](https://comfyanonymous.github.io/ComfyUI_examples/inpaint/)，支持常规模型和重绘模型。 - [ControlNet 和 T2I-Adapter](https://comfyanonymous.github.io/ComfyUI_examples/controlnet/) - [放大模型 (ESRGAN, ESRGAN variants, SwinIR, Swin2SR, 等...)](https://comfyanonymous.github.io/ComfyUI_examples/upscale_models/) - [GLIGEN](https://comfyanonymous.github.io/ComfyUI_examples/gligen/) - [模型合并](https://comfyanonymous.github.io/ComfyUI_examples/model_merging/) - [LCM 模型和 Loras](https://comfyanonymous.github.io/ComfyUI_examples/lcm/) - 使用 [TAESD](#how-to-show-high-quality-previews) 进行 Latent 预览。 - 完全离线工作：除非你愿意，否则核心绝不会下载任何东西。 - 可选的 API 节点，通过在线 [Comfy API](https://docs.comfy.org/tutorials/api-nodes/overview) 使用来自外部提供商的付费模型，使用此参数禁用：`--disable-api-nodes` - [配置文件](extra_model_paths.yaml.example) 用于设置模型的搜索路径。 工作流示例可以在[示例页面](https://comfyanonymous.github.io/ComfyUI_examples/)找到。 ## 发布流程 ComfyUI 遵循每周发布周期，目标定于周一，但由于模型发布或代码库的重大更改，这经常会变动。共有三个相互关联的存储库： 1. **[ComfyUI Core](https://github.com/comfyanonymous/ComfyUI)** - 大约每周发布一个新的稳定版本（例如 v0.7.0）。 - 从 v0.4.0 开始，补丁版本将用于回溯到当前稳定版本的修复。 - 次版本号将用于主分支的发布。 - 在某些不适合回溯的情况下，补丁版本仍可能用于主分支的发布。 - 稳定版本标签之外的提交可能非常不稳定，并可能破坏许多自定义节点。 - 作为桌面版本的基础 2. **[ComfyUI Desktop](https://github.com/Comfy-Org/desktop)** - 使用最新的稳定核心版本构建新版本 3. **[ComfyUI Frontend](https://github.com/Comfy-Org/ComfyUI_frontend)** - 每周的前端更新会合并到核心存储库中 - 即将发布的核心版本的功能已冻结 - 下一发布周期的开发工作继续进行 ## 快捷键 | 组合键 | 说明 | |------------------------------------|--------------------------------------------------------------------------------------------------------------------| | `Ctrl` + `Enter` | 将当前图形加入队列生成 | | `Ctrl` + `Shift` + `Enter` | 将当前图形作为首个任务加入队列生成 | | `Ctrl` + `Alt` + `Enter` | 取消当前生成 | | `Ctrl` + `Z`/`Ctrl` + `Y` | 撤销/重做 | | `Ctrl` + `S` | 保存工作流 | | `Ctrl` + `O` | 加载工作流 | | `Ctrl` + `A` | 选择所有节点 | | `Alt `+ `C` | 折叠/展开选中的节点 | | `Ctrl` + `M` | 静音/取消静音选中的节点 | | `Ctrl` + `B` | 旁路选中的节点（效果如同将该节点从图中移除并重新连接线路） | | `Delete`/`Backspace` | 删除选中的节点 | | `Ctrl` + `Backspace` | 删除当前图形 | | `Space` | 按住并移动光标以移动画布 | | `Ctrl`/`Shift` + `Click` | 将点击的节点加入选择 | | `Ctrl` + `C`/`Ctrl` + `V` | 复制并粘贴选中的节点（不保持与未选中节点输出的连接） | | `Ctrl` + `C`/`Ctrl` + `Shift` + `V` | 复制并粘贴选中的节点（保持未选中节点的输出到粘贴节点输入的连接） | | `Shift` + `Drag` | 同时移动多个选中的节点 | | `Ctrl` + `D` | 加载默认图形 | | `Alt` + `+` | 画布放大 | | `Alt` + `-` | 画布缩小 | | `Ctrl` + `Shift` + LMB + Vertical drag | 画布放大/缩小 | | `P` | 固定/取消固定选中的节点 | | `Ctrl` + `G` | 编组选中的节点 | | `Q` | 切换队列的可见性 | | `H` | 切换历史记录的可见性 | | `R` | 刷新图形 | | `F` | 显示/隐藏菜单 | | `.` | 视图适应选中内容（未选中任何内容时适应整个图形） | | Double-Click LMB | 打开节点快速搜索面板 | | `Shift` + Drag | 同时移动多条连线 | | `Ctrl` + `Alt` + LMB | 断开点击插槽的所有连线 | macOS 用户可以用 `Cmd` 代替 `Ctrl` # 安装 ## Windows 便携版 在[发布页面](https://github.com/comfyanonymous/ComfyUI/releases)有一个适用于 Windows 的独立便携版，支持在 Nvidia GPU 上运行或仅使用 CPU 运行。 ### [直接下载链接](https://github.com/comfyanonymous/ComfyUI/releases/latest/download/ComfyUI_windows_portable_nvidia.7z) 只需下载，使用 [7-Zip](https://7-zip.org) 或在较新的 Windows 版本上使用 Windows 资源管理器解压并运行。对于较小的模型，通常只需将 checkpoints（巨大的 ckpt/safetensors 文件）放入：ComfyUI\models\checkpoints，但许多较大的模型有多个文件。请务必按照说明将它们放入 ComfyUI\models\ 的相应子文件夹中。 如果你在解压时遇到问题，请右键单击文件 -> 属性 -> 解除锁定 上面的便携版目前附带 python 3.13 和 pytorch cuda 13.0。如果无法启动，请更新你的 Nvidia 驱动程序。 #### 替代下载： [适用于 AMD GPU 的实验性便携版](https://github.com/comfyanonymous/ComfyUI/releases/latest/download/ComfyUI_windows_portable_amd.7z) [带有 pytorch cuda 12.6 和 python 3.12 的便携版](https://github.com/comfyanonymous/ComfyUI/releases/latest/download/ComfyUI_windows_portable_nvidia_cu126.7z)（支持 Nvidia 10 系列及更早的 GPU）。 #### 如何在另一个 UI 和 ComfyUI 之间共享模型？ 请参阅[配置文件](extra_model_paths.yaml.example)以设置模型的搜索路径。在独立的 Windows 版本中，你可以在 ComfyUI 目录中找到此文件。将此文件重命名为 extra_model_paths.yaml 并使用你喜欢的文本编辑器进行编辑。 ## [comfy-cli](https://docs.comfy.org/comfy-cli/getting-started) 你可以使用 comfy-cli 安装并启动 ComfyUI： ``` pip install comfy-cli comfy install ``` ## 手动安装 (Windows, Linux) Python 3.14 可用，但某些自定义节点可能存在问题。自由线程变体可用，但某些依赖项将启用 GIL，因此未完全受支持。 Python 3.13 受到很好的支持。如果你在 3.13 上遇到某些自定义节点依赖项问题，可以尝试 3.12 支持 torch 2.4 及更高版本，但某些功能和优化可能仅适用于较新版本。我们通常建议使用最新主要版本的 pytorch 和最新的 cuda 版本，除非它发布不到 2 周。 ### 说明： Git clone 此仓库。 将你的 SD checkpoints（巨大的 ckpt/safetensors 文件）放入：models/checkpoints 将你的 VAE 放入：models/vae ### AMD GPU (Linux) AMD 用户可以使用 pip 安装 rocm 和 pytorch（如果尚未安装），这是安装稳定版本的命令： ```pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.1``` 这是安装带有 ROCm 7.2 的 nightly 版本的命令，可能会有一些性能改进： ```pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.2``` ### AMD GPU（实验性：Windows 和 Linux），仅限 RDNA 3、3.5 和 4。 这些版本的硬件支持不如上面的版本，但可以在 Windows 上运行。你还需要安装特定于你硬件的 pytorch 版本。 RDNA 3 (RX 7000 series): ```pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-all/``` RDNA 3.5 (Strix halo/Ryzen AI Max+ 365): ```pip --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/``` RDNA 4 (RX 9000 series): ```pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/``` ### Intel GPU (Windows 和 Linux) Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在[这里](https://pytorch.org/docs/main/notes/get_start_xpu.html)找到 1. 要安装 PyTorch xpu，请使用以下命令： ```pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu``` 这是安装 Pytorch xpu nightly 版本的命令，可能会有一些性能改进： ```pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu``` ### NVIDIA Nvidia 用户应使用此命令安装稳定版 pytorch： ```pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130``` 这是安装 pytorch nightly 版本的命令，可能会有性能改进。 ```pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130``` #### 故障排除 如果出现 "Torch not compiled with CUDA enabled" 错误，请使用以下命令卸载 torch： ```pip uninstall torch``` 并使用上面的命令再次安装。 ### 依赖项 通过在 ComfyUI 文件夹中打开终端并运行以下命令来安装依赖项： ```pip install -r requirements.txt``` 完成此操作后，你应该已经安装了所有内容，可以继续运行 ComfyUI。 ### 其他： #### Apple Mac silicon 你可以在任何近期 macOS 版本的 Apple Mac silicon (M1 或 M2) 上安装 ComfyUI。 1. 安装 pytorch nightly。有关说明，请阅读 Apple 开发者指南[Mac 上的加速 PyTorch 训练](https://developer.apple.com/metal/pytorch/)（确保安装最新的 pytorch nightly）。 2. 按照 Windows 和 Linux 的[ComfyUI 手动安装](#manual-install-windows-linux)说明进行操作。 3. 安装 ComfyUI [依赖项](#dependencies)。如果你有另一个 Stable Diffusion UI，[你可能可以重用这些依赖项](#i-already-have-another-ui-for-stable-diffusion-installed-do-i-really-have-to-install-all-of-these-dependencies)。 4. 通过运行 `python main.py` 启动 ComfyUI #### Ascend NPU 适用于兼容 Ascend Extension for PyTorch (torch_npu) 的模型。首先，请确保你的环境满足[安装](https://ascend.github.io/docs/sources/ascend/quick_install.html)页面上列出的先决条件。以下是针对你的平台和安装方法定制的分步指南： 1. 首先，如有必要，请安装 torch-npu 安装页面中指定的 Linux 推荐或更新的内核版本。 2. 接下来，按照针对特定平台提供的说明安装 Ascend Basekit，其中包括驱动程序、固件和 CANN。 3. 然后，按照[安装](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch)页面上的平台特定说明安装 torch-npu 所需的软件包。 4. 最后，遵守 Linux 的[ComfyUI 手动安装](#manual-install-windows-linux)指南。安装完所有组件后，你可以如前所述运行 ComfyUI。 #### Cambricon MLU 适用于兼容 Cambricon Extension for PyTorch (torch_mlu) 的模型。以下是针对你的平台和安装方法定制的分步指南： 1. 按照[安装](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html)页面上的平台特定说明安装 Cambricon CNToolkit 2. 接下来，按照[安装](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html)页面上的说明安装 PyTorch(torch_mlu) 3. 通过运行 `python main.py` 启动 ComfyUI #### Iluvatar Corex 适用于兼容 Iluvatar Extension for PyTorch 的模型。以下是针对你的平台和安装方法定制的分步指南： 1. 按照[安装](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536)页面上的平台特定说明安装 Iluvatar Corex Toolkit 2. 通过运行 `python main.py` 启动 ComfyUI ## [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager/tree/manager-v4) **ComfyUI-Manager** 是一个扩展，允许你轻松安装、更新和管理 ComfyUI 的自定义节点。 ### 设置 1. 安装管理器依赖项： pip install -r manager_requirements.txt 2. 运行 ComfyUI 时使用 `--enable-manager` 标志启用管理器： python main.py --enable-manager ### 命令行选项 | 标志 | 描述 | |------|-------------| | `--enable-manager` | 启用 ComfyUI-Manager | | `--enable-manager-legacy-ui` | 使用旧版管理器 UI 而不是新 UI（需要 `--enable-manager`） | | `--disable-manager-ui` | 禁用管理器 UI 和端点，同时保留后台功能（如安全检查和计划安装完成）（需要 `--enable-manager`） | # 运行 ```python main.py``` ### 对于 ROCm 未正式支持的 AMD 显卡 如果遇到问题，请尝试使用此命令运行： 对于 6700, 6600 及其他 RDNA2 或更早版本：```HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py``` 对于 AMD 7600 及其他 RDNA3 显卡：```HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py``` ### AMD ROCm 技巧 你可以使用此命令在 ComfyUI 中为某些 AMD GPU 启用近期 pytorch 中的实验性内存高效注意力机制，RDNA3 上应默认启用此功能。如果在最新 pytorch 上这提高了你的 GPU 速度，请报告，以便我将其设为默认。 ```TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 python main.py --use-pytorch-cross-attention``` 你也可以尝试设置此环境变量 `PYTORCH_TUNABLEOP_ENABLED=1`，这可能会加快速度，但代价是初始运行非常慢。 # 说明 只有具有正确输入的输出部分的图形才会被执行。 只有从每次执行到下一次执行发生变化的图形部分才会被执行，如果你提交相同的图形两次，则只有第一个会被执行。如果你更改了图形的最后部分，则只有你更改的部分以及依赖于它的部分会被执行。 将生成的 png 拖到网页上或加载一个，将为你提供完整的工作流，包括用于创建它的种子。 你可以使用 () 更改单词或短语的强调，例如： 或。() 的默认强调为 1.1。要在实际提示词中使用 () 字符，请像 \\( 或 \\) 这样转义它们。 你可以使用 {day|night} 进行通配符/动态提示。使用此语法 "{wild|card|test}" 将在每次你将提示加入队列时由前端随机替换为 "wild"、"card" 或 "test"。要在实际提示词中使用 {} 字符，请像这样转义它们：\\{ 或 \\}。 动态提示还支持 C 风格的注释，如 `// comment` 或 `/* comment */`。 要在文本提示中使用 textual inversion 概念/embeddings，请将它们放入 models/embeddings 目录，并在 CLIPTextEncode 节点中像这样使用它们（可以省略 .pt 扩展名）： ```embedding:embedding_filename.pt``` ## 如何显示高质量预览？ 使用 ```--preview-method auto``` 启用预览。 默认安装包括一种快速的、低分辨率的 latent 预览方法。要使用 [TAESD](https://github.com/madebyollin/taesd) 启用更高质量的预览，请下载 [taesd_decoder.pth, taesdxl_decoder.pth, taesd3_decoder.pth 和 taef1_decoder.pth](https://github.com/madebyollin/taesd/) 并将它们放入 `models/vae_approx` 文件夹。安装完成后，重启 ComfyUI 并使用 `--preview-method taesd` 启动以启用高质量预览。 ## 如何使用 TLS/SSL？ 通过运行以下命令生成自签名证书（不适用于共享/生产环境）和密钥：`openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 3650 -nodes -subj "/C=XX/ST=StateName/L=CityName/O=CompanyName/OU=CompanySectionName/CN=CommonNameOrHostname"` 使用 `--tls-keyfile key.pem --tls-certfile cert.pem` 启用 TLS/SSL，应用程序现在将可以通过 `https://...` 而不是 `http://...` 访问。 ## 支持和开发频道 [Discord](https://comfy.org/discord)：请尝试 #help 或 #feedback 频道。 [Matrix space: #comfyui_space:matrix.org](https://app.element.io/#/room/%23comfyui_space%3Amatrix.org)（类似于 discord 但是开源的）。 另请参阅：[https://www.comfy.org/](https://www.comfy.org/) ## 前端开发 自 2024 年 8 月 15 日起，我们已过渡到新的前端，该前端现在托管在一个单独的存储库中：[ComfyUI Frontend](https://github.com/Comfy-Org/ComfyUI_frontend)。该存储库现在在 `web/` 目录下托管编译后的 JS（来自 TS/Vue）。 ### 报告问题和功能请求 对于与前端相关的任何错误、问题或功能请求，请使用 [ComfyUI Frontend 存储库](https://github.com/Comfy-Org/ComfyUI_frontend)。这将帮助我们更有效地管理和解决前端特定的问题。 ### 使用最新前端 新的前端现已成为 ComfyUI 的默认设置。但是，请注意： 1. 主 ComfyUI 存储库中的前端每两周更新一次。 2. 单独的前端存储库中提供每日版本。 要使用最新的前端版本： 1. 对于最新的每日版本，使用此命令行参数启动 ComfyUI： --front-end-version Comfy-Org/ComfyUI_frontend@latest 2. 对于特定版本，将 `latest` 替换为所需的版本号： --front-end-version Comfy-Org/ComfyUI_frontend@1.2.2 这种方法允许你轻松地在稳定的每两周发布版和最前沿的每日更新之间切换，甚至切换到特定版本进行测试。 ### 访问旧版前端 如果出于任何原因需要使用旧版前端，可以使用以下命令行参数访问它： ``` --front-end-version Comfy-Org/ComfyUI_legacy_frontend@latest ``` 这将使用[ComfyUI Legacy Frontend 存储库](https://github.com/Comfy-Org/ComfyUI_legacy_frontend)中保留的旧版前端快照。 # 常见问题 ### 我应该购买哪种 GPU？ [请参阅此页面了解一些建议](https://github.com/comfyanonymous/ComfyUI/wiki/Which-GPU-should-I-buy-for-ComfyUI)

标签：AIGC, AI绘画, API服务, ComfyUI, GUI, Homebrew安装, Latent Diffusion, Python, SDXL, Stable Diffusion, 人工智能, 低代码, 凭据扫描, 可视化编程, 图像合成, 图像处理, 图像生成, 工作流自动化, 扩散模型, 无后门, 模型推理, 深度学习, 生成式AI, 用户模式Hook绕过, 索引, 节点编辑器, 逆向工具