StableSwarmUI

环境要求

• 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. 1确认系统与依赖

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

2. 2安装基础依赖

   Linux 用系统包管理器安装 git、python3 及 pip/venv，例如近期 Ubuntu 可执行左侧命令。

   sudo apt install git python3-pip python3-venv

   复制

3. 3Mac 安装依赖

   Mac 用户先更新并检查 brew，再用 brew 安装 dotnet、python 与 virtualenv。

   brew update
   brew doctor
   brew install dotnet
   brew install python@3.10
   brew install virtualenv

   复制

4. 4克隆仓库

   切换到想安装的目录后克隆仓库；Windows 也可直接下载 install-windows.bat 运行。

   git clone https://github.com/Stability-AI/StableSwarmUI

   复制

5. 5运行启动脚本

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

   cd StableSwarmUI
   ./launch-linux.sh

   复制

6. 6打开安装页面

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

7. 7完成网页端安装

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

8. 8以后重新启动

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

   ./launch-linux.sh

   复制

关键配置

如何确认成功

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

常见问题

注意事项

• 安装位置不要选 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 状态，功能仍在完善中。