SwarmUI

让 Stable Diffusion 高级功能变得人人可用，拖拽即可生成专业级图像

SwarmUI 是一个模块化的 Stable Diffusion 网页用户界面，前身为 StableSwarmUI。它致力于将 Stable Diffusion 及 ComfyUI 等底层工具的强大能力封装成易于使用的界面，同时保持高性能和可扩展性。项目采用 C# 与 Python 混合开发，前端使用 JavaScript，通过模块化架构让用户能灵活组合图像生成工作流。它解决了原生 ComfyUI 节点式界面学习曲线陡峭、操作复杂的问题，为普通用户提供更直观的图形化操作，同时保留对底层参数的精细控制。核心能力包括：集成 ComfyUI 后端、支持多模型管理、提供丰富的图像生成选项（如采样器、CFG、尺寸等）、支持批量生成和队列管理，并允许通过插件扩展新功能。其设计强调‘让高级工具触手可及’，适合从新手到专业用户的广泛群体。

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4589

维护状态活跃

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队mcmonkeyprojects

所属国家

官网地址

GitHubhttps://github.com/mcmonkeyprojects/SwarmUI

定价模式free

价格说明开源项目，MIT许可证，可免费自部署使用，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言C#

技术栈/模型ai,comfyui,csharp,image-generation,javascript,machine-learning,ml,python,stable-diffusion

GitHub 星标★ 4589

30天Star增速

HF 下载量

上线时间2024-06-21 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 20 分钟部署方式：本地安装 8 步

环境要求

Windows 10 需先手动安装 git 与 DotNET 8 SDK（Windows 11 可自动完成）
手动安装需要 .NET 8 SDK 与 .NET 10 SDK（均选 x64 版本）
Mac 仅支持 M 系列 Apple silicon 芯片（M1、M2 等）
Mac 需 Python 3.11/3.12/3.10，切勿使用 3.14 或更高版本
安装目录不要放在 Program Files 等受限路径

安装与启动步骤

1选择安装方式

可用 Windows/Linux/Mac 本地安装脚本，也可用 Docker 或 Runpod 云 GPU 模板；普通用户建议一键脚本。
2Windows 一键安装

下载 install-windows.bat 放到想安装的目录（不要放 Program Files）后运行；若闪退就再跑一次。
3Windows 手动安装

先装 git 与 DotNET 8/10 SDK，再克隆仓库并运行启动脚本。
```
git clone https://github.com/mcmonkeyprojects/SwarmUI
cd SwarmUI
launch-windows.bat
```

4Linux 一键安装

下载官方脚本并赋可执行权限后运行，脚本会自动装好依赖并打开网页。

wget https://github.com/mcmonkeyprojects/SwarmUI/releases/download/0.6.5-Beta/install-linux.sh -O install-linux.sh
chmod +x install-linux.sh
./install-linux.sh

5Linux 手动安装

克隆仓库后用 launchtools 脚本安装 .NET 8/10 SDK，再运行启动脚本。

git clone https://github.com/mcmonkeyprojects/SwarmUI
cd SwarmUI
./launchtools/linux-dotnet-install.sh
./launch-linux.sh

6无头服务器启动

无图形界面的服务器加参数启动，也可把 host 换成 cloudflared 做隧道访问。
```
./launch-linux.sh --launch_mode none --host 0.0.0.0
```

7Mac 安装

仅 M 系列芯片可用；先 brew 装 dotnet 与 Python，再克隆仓库运行脚本。

brew update
brew doctor
brew install dotnet
brew install python@3.11
brew install virtualenv
git clone https://github.com/mcmonkeyprojects/SwarmUI
cd SwarmUI
./launch-macos.sh

8Docker 部署

README 未给出 Docker 具体命令，请按官方 docs/Docker.md 的详细说明操作。

关键配置

配置项	必填	说明	示例
`--launch_mode`	否	启动模式，设为 none 表示不自动打开浏览器界面	`none`
`--host`	否	监听地址，0.0.0.0 允许外部网络访问	`0.0.0.0`

如何确认成功

浏览器会自动打开安装页；若未打开，手动访问 http://localhost:7801/Install 并跟随页面提示完成安装。

常见问题

Q：Windows 安装脚本窗口一闪就关了怎么办？

A：README 说明这是已知问题，直接再运行一次 install-windows.bat 即可，有时需要运行两次。

Q：页面没有自动打开怎么办？

A：手动在浏览器打开 http://localhost:7801/Install，安装完成后日常访问 http://localhost:7801。

Q：Mac 用 Intel 芯片能装吗？

A：不能。SwarmUI 在 Mac 上只支持 M 系列 Apple silicon 处理器（如 M1、M2）。

Q：以后怎么重新启动服务？

A：Linux/Mac 重新运行 launch-linux.sh 或 launch-macos.sh；Windows 双击桌面生成的图标即可。

Q：Docker 怎么部署？

A：README 未在正文给出命令，需查看仓库内 docs/Docker.md 的详细说明。

注意事项

安装目录不要放在 Program Files，建议放在自己可写的目录下。
提交安装后需要下载模型等资源，可能耗时数分钟，请耐心等待。
Mac 不要使用 Python 3.14 或更高版本，3.11/3.12/3.10 均可。
当前版本目标 .NET 8，未来会转向 .NET 10，建议两个 SDK 都提前安装。

核心亮点

模块化架构，可灵活扩展新功能，且与 ComfyUI 深度集成，复用其强大工作流
提供直观的 Web 界面，大幅降低 Stable Diffusion 使用门槛，新手也能快速上手
性能优化到位，支持批量生成和队列管理，适合高吞吐量图像生产场景

不足之处

文档/社区待观察，项目仍在快速迭代，部分功能可能不稳定
C# 与 Python 混合技术栈，对二次开发者有一定语言门槛

适用场景

个人创作者快速生成 AI 图像，无需深入理解底层模型参数
团队搭建内部图像生成平台，需要统一管理和批量处理任务
开发者基于其模块化架构，定制专属图像生成工作流

替代项目

AUTOMATIC1111/stable-diffusion-webui、ComfyUI、InvokeAI

项目介绍

SwarmUI 是图像领域的开源项目，由 mcmonkeyprojects 开发，2024 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（4,589）位列前 10%，在图像分类的 837 个项目里位列前 5%。

近 44 天，它的 GitHub 星标从 4,437 增加到 4,589，净增 152。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，可免费自部署使用，无付费版本。

它主要面向的使用场景是：个人创作者快速生成AI图像，无需深入理解底层模型参数。同类可对比的替代方案包括 AUTOMATIC1111/stable-diffusion-webui、ComfyUI、InvokeAI。

上一篇：snappy

下一篇：GPT-Image2-Skill