StableSwarmUI
StableSwarmUI 0.6.4.1 Beta。
一个模块化的Stable Diffusion网页用户界面,重点是使强大工具易于访问、高性能和可扩展性。
加入Discord讨论该项目、获取支持、查看公告等。
关注功能公告线程以获取新功能的更新。
迁移通知
从2024年6月21日起,StableSwarmUI将不再由Stability AI维护。
原开发者将维护该项目的独立版本为mcmonkeyprojects/SwarmUI
Windows用户可以通过简单更新并运行migrate-windows.bat
迁移到新的独立仓库。
对于Linux、Mac或手动Windows用户:在Swarm文件夹中打开终端,然后运行git remote set-url origin https://github.com/mcmonkeyprojects/SwarmUI
查看完整的迁移指南:https://github.com/mcmonkeyprojects/SwarmUI/discussions/2
状态
该项目目前处于Beta状态。这意味着对于大多数任务,Swarm都为您提供了出色的工具,但还有很多计划正在进行中。Swarm被推荐作为大多数用户(初学者和专业人士)的理想UI,但仍有一些问题需要解决。
初学者用户会喜欢Swarm的主生成标签界面,这使得通过各种强大功能生成任何内容变得容易。高级用户可能更喜欢使用Comfy Workflow标签来获取不受限制的原始图表,但仍然会因为便利功能(图像编辑器、自动工作流生成等)和强大工具(如网格生成器)而返回生成标签。
那些有兴趣帮助将Swarm从Beta推向一个完全准备好的完美发布状态的人,欢迎提交PR(请先阅读贡献文档),并且可以在GitHub或Discord上联系我们。我强烈建议在提交PR之前先咨询有关某功能的计划。可能已经有了具体的计划,甚至正在进行的工作。
尚未实现的关键功能目标:
- 更好的移动浏览器支持
- 在UI中显示完整的“当前模型”细节,独立于模型选择器(可能作为批处理侧边栏中的一个标签?)
- 以及一种动态调整标签在各个位置之间的方式,以方便布局定制
- LLM辅助提示
- 便捷的Swarm直接分发为程序(Electron应用?)
在Google Colab或Runpod上试用
Google Colab
警告:Google Colab不一定允许远程WebUIs,特别是对于免费账户,使用需自行承担风险。
如果您想试用Swarm,可以使用此Colab链接:https://colab.research.google.com/github/Stability-AI/StableSwarmUI/blob/master/colab/colab-notebook.ipynb
Runpod
Runpod模板(注意:由第三方贡献者nerdylive123维护):https://runpod.io/console/deploy?template=u7mlkrmxq3&ref=c6jd6jj0
第一次启动可能需要几分钟。检查容器日志以查看设置进度。查看模板?
信息以获取使用提示。
在Windows上安装
注意:如果您使用的是Windows 10,可能需要先手动安装git和DotNET 8。(Windows 11自动完成)
- 下载Install-Windows.bat文件,将其存储在您要安装的位置(不要放在
Program Files
),然后运行它。- 它应该会打开一个命令提示符并自行安装。
- 如果它关闭而没有进一步运行,尝试再次运行,有时需要运行两次。(待办事项:修复此问题)
- 它会在桌面上放置一个图标,您可以随时使用该图标重新启动服务器。
- 当安装程序完成时,它会自动启动StableSwarmUI服务器,并打开一个浏览器窗口指向安装页面。
- 按照页面上的安装说明进行操作。
- 提交后请耐心等待,一些安装处理可能需要几分钟(如下载模型等)。
(待办事项):更简单的自包含预安装程序,一个.msi
或.exe
文件,提供通用的安装界面并让您选择文件夹等。
替代的手动Windows安装
- 从https://git-scm.com/download/win安装git
- 从https://dotnet.microsoft.com/en-us/download/dotnet/8.0安装DotNET 8 SDK(确保获取适用于Windows的SDK x64)
- 打开终端到您想放置Swarm的文件夹并运行
git clone https://github.com/Stability-AI/StableSwarmUI
- 打开文件夹并运行
launch-windows.bat
在Linux上安装
-
通过操作系统的包管理器安装
git
、python3
(如果尚未安装)(确保在不直接包含的发行版中包含pip
和venv
)- 例如,在最近的Ubuntu版本中,运行
sudo apt install git python3-pip python3-venv
- 例如,在最近的Ubuntu版本中,运行
-
下载install-linux.sh文件,将其存储在您要安装的位置,然后运行它
- 如果您喜欢终端,可以打开终端到该文件夹并运行以下命令:
wget https://github.com/Stability-AI/StableSwarmUI/releases/download/0.6.1-Beta/install-linux.sh -O install-linux.sh
chmod +x install-linux.sh
- 如果您喜欢终端,可以打开终端到该文件夹并运行以下命令:
-
运行
./install-linux.sh
脚本,它将为您安装所有内容并最终在浏览器中打开网页。 -
按照页面上的安装说明进行操作。
-
未来任何时候,您都可以运行
launch-linux.sh
脚本重新启动Swarm。 -
如果页面没有自动打开,您可以手动打开
http://localhost:7801
替代的手动Linux安装
- 如果尚未安装,请通过操作系统的包管理器安装
git
和python3
(确保在不直接包含它们的发行版中包括pip
和venv
)- 例如,在最近的 Ubuntu 版本中,可以运行
sudo apt install git python3-pip python3-venv
- 例如,在最近的 Ubuntu 版本中,可以运行
- 按照 https://dotnet.microsoft.com/en-us/download/dotnet/8.0 的说明安装 DotNET 8(需要
dotnet-sdk-8.0
,因为它包含了所有相关的子包)- 有些用户表示某些 Linux 发行版需要单独安装
aspnet-runtime
- 有些用户表示某些 Linux 发行版需要单独安装
- 打开一个 shell 终端并
cd
到你想安装的目录 - 运行以下 shell 命令:
git clone https://github.com/Stability-AI/StableSwarmUI
cd StableSwarmUI
./launch-linux.sh
- 打开
http://localhost:7801/Install
(如果它没有自动启动) - 按照页面上的安装说明进行操作。
(TODO):也许可以链接一个专门的文档,其中包含针对不同发行版的详细信息和其他内容。也可以为 Linux 制作一个一键安装程序?
在 Mac 上安装
注意:你只能在配备 M1 或 M2 (Mx) 苹果芯片处理器的 Mac 电脑上运行 StableSwarmUI。
- 打开终端。
- 使用
brew update
确保你的brew
包是最新的。 - 使用
brew doctor
验证你的brew
安装。命令输出中不应出现任何错误。 - 为 macOS 安装 .NET:
brew install dotnet
。 - 如果没有 Python,请安装它:
brew install python@3.10
和brew install virtualenv
- 将目录更改(
cd
)到你想要安装 StableSwarmUI 的文件夹中。 - 克隆 StableSwarmUI 的 GitHub 仓库:
git clone https://github.com/Stability-AI/StableSwarmUI
。 cd StableSwarmUI
并运行安装脚本:./launch-macos.sh
。
安装现在开始,并从互联网上下载 Stable Diffusion 模型。根据你的网络连接情况,这可能需要几分钟。等待你的网页浏览器打开 StableSwarmUI 窗口。
在安装 StableSwarmUI 的过程中,系统会提示你选择要使用的后端类型。对于配备 M1 或 M2 的 Mac 电脑,你可以放心选择 ComfyUI 后端,并在下载模型页面选择 Stable Diffusion XL Base 和 Refiner 模型。
使用 Docker 运行
- 要转发 Nvidia GPU,必须安装 Nvidia Container Toolkit:https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html
- 打开一个 shell 终端并
cd
到你想安装的目录 - 运行以下 shell 命令:
git clone https://github.com/Stability-AI/StableSwarmUI
cd StableSwarmUI
./launch-docker.sh
- 在浏览器中打开
localhost:7801
- 请注意,它会转发
Models
和Output
目录,并将Data
和dlbackend
作为独立的持久卷挂载。
文档
请参阅文档文件夹。
动机
"Swarm" 名称是指用户界面的原始关键功能:使一群 GPU 能够同时为同一用户生成图像(特别是用于大型网格生成)。这只是激发名称的功能,而不是 Swarm 的最终目标。
StableSwarmUI 的总体目标是成为一个全面的、一站式的 Stable Diffusion 平台。
有关技术选择动机,请参阅动机文档。
法律
该项目:
- 嵌入了 7-zip(LGPL)的副本。
- 具有自动安装 ComfyUI(GPL)的功能。
- 可以选择使用作为后端的 AUTOMATIC1111/stable-diffusion-webui(AGPL)。
- 可以自动安装 christophschuhmann/improved-aesthetic-predictor(Apache2)。
- 可以自动安装 yuvalkirstain/PickScore(MIT)。
- 可以自动安装 git-for-windows(GPLv2)。
- 可以自动安装 MIT/BSD/Apache2/PythonSoftwareFoundation pip 包:spandrel, dill, imageio-ffmpeg, opencv-python-headless, matplotlib, rembg, kornia, Cython
- 可以自动安装 ultralytics(AGPL),用于
YOLOv8
人脸检测(即SwarmYoloDetection
节点或<segment:yolo-...>
语法使用可能会受到 AGPL 条款的约束), - 可以自动安装 insightface(MIT)用于
IP Adapter - Face
支持。 - 使用了 JSON.NET(MIT)、FreneticUtilities(MIT)、LiteDB(MIT)、ImageSharp(Apache2 under open-source Split License)。
- 嵌入了来自 BootStrap(MIT)、Select2(MIT)、JQuery(MIT)、exifr(MIT)的网页资源副本。
- 可以选择连接到远程服务器以使用 the Stability AI API 作为后端。
- 支持用户构建的扩展,可能有自己的许可或法律条件。
StableSwarmUI 本身遵循 MIT 许可证,但某些使用可能会受到上述连接项目的 GPL 变体许可证的影响,请注意使用的任何模型都有自己的许可证。
许可证
MIT 许可证(MIT)
版权所有 (c) 2024 Stability AI
特此免费授予任何获得本软件及相关文档文件(“软件”)副本的人员以下权限,允许其不受限制地使用本软件,包括但不限于使用、复制、修改、合并、出版、分发、再许可和/或销售本软件的副本,并允许获得本软件提供的人员在符合以下条件的情况下也可以这样做:
上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。 软件按“原样”提供,不提供任何形式的明示或暗示担保,包括但不限于对适销性、特定用途适用性和非侵权的担保。在任何情况下,作者或版权持有者均不对因本软件或使用本软件或与本软件有关的其他操作而引发的任何索赔、损害或其他责任承担责任,无论是在合同诉讼、侵权行为或其他情况下。