StableSwarmUI

一个界面管所有生图工具，不用再来回切换

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 402 🐛 待处理 67 👀 关注 71

GitHub ↗

GitHub 星标 ★ 4940

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

StableSwarmUI 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类图像生成

开发团队Stability-AI

GitHubhttps://github.com/Stability-AI/StableSwarmUI

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言C#

技术栈/模型ai,image-generation,stable-diffusion,stablediffusion,ui

GitHub 星标★ 4940

上线时间2023-05-12 00:00:00

代码更新2026-10-15

仓库体积11.5 MB

本站数据更新2026-11-08

维护状态较活跃

收录时间2026-08-09

浏览次数9

项目介绍

Stability AI 推出的模块化 Stable Diffusion Web 界面，将 ComfyUI 等强力工具无缝整合，强调高性能、易扩展与强大工具的无障碍访问，适合追求极致性能与工作流定制的进阶玩家。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4940

技术标签

ai image-generation stable-diffusion stablediffusion ui

使用教程

难度：进阶约 30 分钟部署方式：本地安装 8 步

环境要求

Windows 10/11、Linux，或 M1/M2 芯片的 Mac（Mac 仅支持 Mx Apple silicon）
已安装 git（Windows 10 需手动安装）
已安装 .NET 8 SDK（dotnet-sdk-8.0，部分 Linux 发行版还需单独装 aspnet-runtime）
已安装 python3，且包含 pip 与 venv
使用 Docker 转发 Nvidia GPU 时需先安装 Nvidia Container Toolkit

安装与启动步骤

1确认系统与依赖

Windows 10 需先手动装 git 与 DotNET 8，Windows 11 由脚本自动处理；Mac 仅支持 M1/M2。安装目录不要选 Program Files。
2安装基础依赖

Linux 用系统包管理器安装 git、python3 及 pip/venv，例如近期 Ubuntu 可执行左侧命令。
```
sudo apt install git python3-pip python3-venv
```
3Mac 安装依赖

Mac 用户先更新并检查 brew，再用 brew 安装 dotnet、python 与 virtualenv。
```
brew update
brew doctor
brew install dotnet
brew install python@3.10
brew install virtualenv
```
4克隆仓库

切换到想安装的目录后克隆仓库；Windows 也可直接下载 install-windows.bat 运行。
```
git clone https://github.com/Stability-AI/StableSwarmUI
```
5运行启动脚本

进入目录执行对应平台脚本，脚本会自动安装依赖并尝试打开浏览器。Windows 用 launch-windows.bat，Mac 用 launch-macos.sh。
```
cd StableSwarmUI
./launch-linux.sh
```
6打开安装页面

若浏览器未自动打开，手动访问下方地址进入安装页，并按页面指引填写配置。
7完成网页端安装

在页面中提交后要耐心等待，后续步骤会下载模型等资源，可能耗时数分钟。Mac 建议选 ComfyUI 后端并下载 SDXL Base 与 Refiner。
8以后重新启动

安装完成后随时可再次运行启动脚本重新拉起服务；Windows 桌面图标同样可用。
```
./launch-linux.sh
```

关键配置

配置项	必填	说明	示例
`访问端口`	否	Swarm 默认的 Web 访问端口	`7801`
`Models 目录`	否	Docker 运行时会转发该目录，用于存放模型	`Models`
`Output 目录`	否	Docker 运行时会转发该目录，用于存放生成结果	`Output`
`Data 卷`	否	Docker 下作为独立持久化卷挂载	`Data`
`dlbackend 卷`	否	Docker 下作为独立持久化卷挂载	`dlbackend`

如何确认成功

浏览器打开 http://localhost:7801 能看到 Swarm 页面（首次为 /Install 安装页），即表示服务已启动。

常见问题

Q：Windows 安装脚本一闪就关闭怎么办？

A：再运行一次即可，该脚本有时需要运行两次才能继续安装。

Q：浏览器没有自动打开界面？

A：手动在浏览器访问 http://localhost:7801；首次安装请访问 http://localhost:7801/Install。

Q：首次启动或安装很慢正常吗？

A：正常，需要下载模型等资源，可能耗时数分钟；用 Runpod 等容器时可查看容器日志了解进度。

Q：Mac 上能安装吗？

A：只能在搭载 M1 或 M2（Mx）Apple 芯片的 Mac 上运行。

Q：这个项目还在维护吗？

A：2024/06/21 起不再由 Stability AI 维护，原作者在 mcmonkeyprojects/SwarmUI 继续维护独立版本。

注意事项

安装位置不要选 Program Files 等受保护目录。
Windows 用户迁移到新仓库可更新后运行 migrate-windows.bat；Linux/Mac/手动安装可执行 git remote set-url origin https://github.com/mcmonkeyprojects/SwarmUI。
用 Docker 转发 Nvidia GPU 前必须先安装 Nvidia Container Toolkit，随后运行 launch-docker.sh 并访问 localhost:7801。
项目处于 Beta 状态，功能仍在完善中。