---

ComfyUI-Easy-Install

一键式便携 ComfyUI，搭载 EZi Desktop：用于管理软件包、环境和配置的完整控制面板
Windows • NVIDIA GPUs • Pixaroma Community Edition

[![GitHub Release](https://img.shields.io/github/v/release/Tavris1/ComfyUI-Easy-Install)](https://github.com/Tavris1/ComfyUI-Easy-Install/releases/latest/download/ComfyUI-Easy-Install.zip) [![GitHub Release Date](https://img.shields.io/github/release-date/Tavris1/ComfyUI-Easy-Install?style=flat&label=date)](https://github.com/Tavris1/ComfyUI-Easy-Install/releases) [![Downloads](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/Tavris1/95cfc6f0535930f25591dcfe08f34cc1/raw/downloads.json)](https://github.com/Tavris1/ComfyUI-Easy-Install/releases)

📥 安装 · ✨ 功能/组件 · 🍎 macOS/Linux · 💬 Pixaroma Discord · ❤️ 支持开发

![ComfyUI Screenshot](ComfyUI-ivo.png)

## ✨ 功能 **ComfyUI-Easy-Install** 提供包含 **EZi Desktop** 的便携式 ComfyUI 环境。无需手动安装或配置 Python 和 Git。只需一键即可安装 Nunchaku、SageAttention、FlashAttention、InsightFace 等复杂软件包。可在同一位置管理 **模型、软件包、PyTorch/CUDA 版本、Dynamic VRAM、 ComfyUI/frontend 版本、UV/PIP 缓存以及 GGUF 转换**。 ## 📦 包含的组件

核心组件

| 🔧 组件 | 📝 说明 | |---|---| | [Git](https://git-scm.com/) | ![Git version](https://img.shields.io/github/v/tag/git/git?label=&display_name=tag&color=blue) - 最新版本（如有需要将自动安装/更新） | | [Python](https://www.python.org/downloads/release/python-31210/) | ![Python version](https://img.shields.io/badge/3.12.10-blue) - Embedded 版本 | | [ComfyUI](https://github.com/Comfy-Org/ComfyUI) | ![ComfyUI version](https://img.shields.io/github/v/release/Comfy-Org/ComfyUI?label=&display_name=tag) - 最新稳定版本 |

Pixaroma 教程中使用的 Nodes

| 🖼️ 图像 | 🎬 视频 | 🎵 音频 | 🧩 工具 / WF | 🤖 模型 | |---|---|---|---|---| | [Tiled Diffusion & VAE](https://github.com/shiimizu/ComfyUI-TiledDiffusion) | [VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) | [MelBandRoFormer](https://github.com/kijai/ComfyUI-MelBandRoFormer) | [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) | [QwenVL](https://github.com/1038lab/ComfyUI-QwenVL) | | [Inpaint CropAndStitch](https://github.com/lquesada/ComfyUI-Inpaint-CropAndStitch) | [WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper) | [Qwen3-TTS](https://github.com/flybirdxx/ComfyUI-Qwen-TTS) | [Easy-Use](https://github.com/yolain/ComfyUI-Easy-Use) | [GGUF](https://github.com/city96/ComfyUI-GGUF) | | [ControlNet Aux](https://github.com/Fannovel16/comfyui_controlnet_aux) | [WanAnimatePreprocess](https://github.com/kijai/ComfyUI-WanAnimatePreprocess) | | [KJNodes](https://github.com/kijai/ComfyUI-KJNodes) | | | [LayerStyle](https://github.com/chflame163/ComfyUI_LayerStyle) | [SeedVR2 VideoUpscaler](https://github.com/numz/ComfyUI-SeedVR2_VideoUpscaler) | | [rgthree](https://github.com/rgthree/rgthree-comfy) | | | [RMBG](https://github.com/1038lab/ComfyUI-RMBG) | | | [iTools](https://github.com/MohammadAboulEla/ComfyUI-iTools) | | | [Easy-Sam3](https://github.com/yolain/ComfyUI-Easy-Sam3) | | | [ControlAltAI Nodes](https://github.com/gseth/ControlAltAI-Nodes) | | | [SCAIL-Pose](https://github.com/kijai/ComfyUI-SCAIL-Pose) | | | ✨[Pixaroma](https://github.com/pixaroma/ComfyUI-Pixaroma) | | | | | | [Krea2T-Enhancer](https://github.com/capitan01R/ComfyUI-Krea2T-Enhancer) | | | | | | [Krea2Edit](https://github.com/lbouaraba/comfyui-krea2edit) | |

可选 Add-ons 和 Tools

| 🧩 Nodes | 🛠️ Tools | |---|---| | [Nunchaku](https://github.com/nunchaku-ai/nunchaku) | Easy-Models-Linker | | [SageAttention (v2.2.0 and v3)](https://github.com/woct0rdho/SageAttention) | Easy-System-Checker | | [FlashAttention](https://github.com/Dao-AILab/flash-attention) | ComfyUI-Version-Switcher | | [InsightFace](https://github.com/deepinsight/insightface) | Easy-model2GGUF | | [Trellis 2.0 + Pixal3D @visualbruno](https://github.com/visualbruno/ComfyUI-Trellis2) | Long-Paths-Enabler | | | Torch-Pack | | | Toggle-DynamicVRAM | | | Update Easy-Install |

--- ## 🖥️ Windows 安装 > [!WARNING] > **Windows 11:** 如果 ComfyUI 显示 **"Bad Image" (`0xc0e90002`)**，请关闭 **Smart App Control** 并重新启动 ComfyUI。
> 这会降低对不可信应用的防护。确认前请阅读 Windows 警告。 > [!IMPORTANT] > - 请勿以 **Administrator** 身份运行安装程序。 > - 避免安装到系统文件夹（`Program Files`、`Windows`、`C:\` 根目录）。 > - 文件夹名称中避免使用空格和特殊字符。 > - 请确保 NVIDIA 驱动程序已更新至最新版本。 1. [**📥 DOWNLOAD LATEST VERSION**](https://github.com/Tavris1/ComfyUI-Easy-Install/releases/latest/download/ComfyUI-Easy-Install.zip) 2. 将 ZIP 文件解压到一个新文件夹，然后运行 **`ComfyUI-Easy-Install.bat`** 3. 安装完成后，可选择从 **Add-ons** 文件夹或 **EZi Desktop Menu** 安装或运行组件： - **Easy-Models-Linker** - *通过 **extra_model_paths.yaml** 使用现有的 **MODELS** 文件夹，无需重新下载* - *某些文件夹，如 **LLM** 和 **llm_gguf**，无法通过此方式重定向* - **Easy-System-Checker** - *提供有关关键硬件和软件组件的信息* - **Nunchaku** - *安装 Nunchaku* - **SageAttention-Multi** - *同时安装 SageAttention v2.2.0 和 v3（v3 仅在 NVIDIA 50-series GPUs 上有效）* - **FlashAttention** - *安装 FlashAttention v2.8.3* - **InsightFace** - *安装 InsightFace* - **Trellis2+Pixal3D @visualbruno** - *安装 Trellis 2.0 + Pixal3D 和模型（需要 `Torch 2.8.0+cu128`）* - **Torch-Pack** - *快速切换：`Torch 2.7.1+cu128`、`Torch 2.8.0+cu128`、 `Torch 2.9.1+cu130`、`Torch 2.10+cu130`、`Torch 2.11+cu130`、`Torch 2.12.1+cu130` 和 `Torch 2.13.0+cu130`* - **Easy-model2GGUF** - *将模型转换并量化为 GGUF（Q2_K–Q8_0），如可用则支持 5D tensor 修复* - **Long-Paths-Enabler** - *在 Windows 10/11 中启用 **Long Paths**。对 Python/ComfyUI 至关重要* - **ComfyUI-Version-Switcher** - *如果出现问题，可**可逆地**回退到**之前的** ComfyUI 版本* - **Toggle-DynamicVRAM** - *切换 ComfyUI 启动文件中的 **--disable-dynamic-vram** 选项* - **Update Easy-Install** - *更新 **Add-ons** 和其他文件夹，并创建桌面快捷方式* - **EZi Desktop Themes** - *通过 EZi Desktop > Menu > Advanced* - **Custom Input, Output & User folders** - *通过 EZi Desktop > Menu > Advanced* - **ComfyUI & Frontend Version Changer** - *通过 EZi Desktop > Menu > Advanced* - **UV & PIP cache cleaner** - *通过 EZi Desktop > Menu* - **ComfyUI-Manager Security-Level Config** - *通过 EZi Desktop > Menu 轻松配置 security_level* - **Pinned-Packages-Manager** - *通过 EZi Desktop > Menu 固定软件包版本，例如 NumPy==1.26.4*

--- ## ❤️ 支持开发喜欢这个项目吗？你的支持有助于项目持续发展。 [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/tavris1) [![Buy Me a Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/tavris1) [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=#white)](https://github.com/sponsors/Tavris1)