SwarmUI

环境要求

• 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. 1选择安装方式

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

2. 2Windows 一键安装

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

3. 3Windows 手动安装

   先装 git 与 DotNET 8/10 SDK，再克隆仓库并运行启动脚本。

   git clone https://github.com/mcmonkeyprojects/SwarmUI
   cd SwarmUI
   launch-windows.bat

   复制

4. 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

   复制

5. 5Linux 手动安装

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

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

   复制

6. 6无头服务器启动

   无图形界面的服务器加参数启动，也可把 host 换成 cloudflared 做隧道访问。

   ./launch-linux.sh --launch_mode none --host 0.0.0.0

   复制

7. 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

   复制

8. 8Docker 部署

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

关键配置

如何确认成功

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

常见问题

注意事项

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