SwarmUI

群組用戶介面

SwarmUI v0.9.3 測試版。

以前稱為StableSwarmUI。

模組化 AI 圖像生成 Web 使用者介面，重點是使 powertools 易於存取、高效能和可擴展性。支援Stable Diffusion、Flux等AI影像模型，未來計畫支援AI視訊、音訊等。

加入 Discord 討論專案、獲取支援、查看公告等。

請關注功能公告線程以獲取新功能的更新。

---

地位

該項目處於測試階段。這意味著對於大多數任務，Swarm 都有出色的工具可供您使用，但還有更多的計劃。 Swarm 被推薦為大多數用戶、初學者和專業人士的理想 UI。還有一些事情要解決。

初學者用戶會喜歡 Swarm 的主要「生成」標籤介面，它可以輕鬆生成具有各種強大功能的任何內容。高級用戶可能更喜歡「舒適工作流程」標籤來獲取不受限制的原始圖表，但仍然有理由返回「生成」選項卡以獲得便利功能（圖像編輯器、自動工作流程生成等）和強大工具（例如網格生成器）。

有興趣幫助將 Swarm 從 Beta 推向完全準備就緒的完美發布狀態的人歡迎提交 PR（首先閱讀貢獻文件），並且您可以在 GitHub 或 Discord 上聯繫我們。我強烈建議您在發布某項功能之前先詢問該功能的計劃。可能已經有了具體的計劃，甚至正在進行中的工作。

尚未實現的關鍵功能目標：

• 更好的行動瀏覽器支持

• UI 中顯示完整詳細資訊“目前模型”，與模型選擇器分開（可能作為批次側邊欄中的選項卡？）

• 以及一種在點之間動態移動選項卡的方法，以方便/佈局定制

• LLM輔助提示

• 將 Swarm 作為程式方便地直接分發（Electron 應用程式？）

在 Google Colab 或 Runpod 上嘗試一下

Google合作實驗室

警告：Google Colab 不一定允許遠端 WebUI，尤其是免費帳戶，請自行承擔風險。

如果您想嘗試 Swarm，請使用 Colab 連結：https://colab.research.google.com/github/mcmonkeyprojects/SwarmUI/blob/master/colab/colab-notebook.ipynb

運行波德

Runpod 範本（註：由第三方貢獻者 nerdylive123 維護）：https://runpod.io/console/deploy?template=u7mlkrmxq3&ref=c6jd6jj0

請注意，第一次啟動可能需要幾分鐘。檢查容器日誌以查看設定進度。檢查模板?有關如何使用的提示資訊。

在 Windows 上安裝

注意：如果您使用的是 Windows 10，您可能需要先手動安裝 git 和 DotNET 8 SDK。 （Windows 11 這是自動化的）。

• 下載 Install-Windows.bat 文件，將其儲存在您要安裝的位置（而不是Program Files ），然後執行它。

• 它應該打開命令提示字元並自行安裝。

• 如果它關閉而沒有進一步，請嘗試再次運行它，有時需要運行兩次。 （待辦事項：解決這個問題）

• 它將在您的桌面上放置一個圖標，您可以使用該圖標隨時重新啟動伺服器。

• 安裝程式完成後，它將自動啟動 SwarmUI 伺服器，並開啟瀏覽器視窗進入安裝頁面。

• 請按照頁面上的安裝說明進行操作。

• 提交後，請耐心等待，某些安裝處理需要幾分鐘（下載模型等）。

(TODO)：更簡單的獨立預安裝程序， .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）

• 打開您想要進入的資料夾的終端機並執行git clone https://github.com/mcmonkeyprojects/SwarmUI

• 開啟資料夾並執行launch-windows.bat

在 Linux 上安裝

• 如果尚未安裝，請透過作業系統套件管理器安裝git 、 python3 （確保在不直接將它們包含在 python 中的發行版上包含pip和venv ）

• 例如，在最近的 Ubuntu 版本上， sudo apt install git python3-pip python3-venv

• 下載 install-linux.sh 文件，將其儲存在您要安裝的位置，然後運行它

• 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腳本，它將為您安裝所有內容並最終在瀏覽器中打開網頁。

• 請按照頁面上的安裝說明進行操作。

• 您可以在以後隨時執行launch-linux.sh腳本來重新啟動 Swarm。

• 如果頁面打不開，可以手動開啟http://localhost:7801

備用手動 Linux 安裝

• 如果尚未安裝，請透過作業系統套件管理器安裝git 、 python3 （確保在不直接將它們包含在 python 中的發行版上包含pip和venv ）

• 例如，在最近的 Ubuntu 版本上， sudo apt install git python3-pip python3-venv

• 使用 https://dotnet.microsoft.com/en-us/download/dotnet/8.0 上的說明安裝 DotNET 8（您需要dotnet-sdk-8.0 ，因為它包含所有相關子套件）

• 有些用戶表示某些 Linux 發行版希望單獨安裝aspnet-runtime

• 打開 shell 終端機並cd到要安裝的目錄

• 運行外殼命令：

• git clone https://github.com/mcmonkeyprojects/SwarmUI

• cd SwarmUI

• ./launch-linux.sh

• 開啟http://localhost:7801/Install （如果它沒有自行啟動）

• 請按照頁面上的安裝說明進行操作。

（TODO）：也許可以連結一個包含每個發行版詳細資訊等的專用文件。也許還可以為 Linux 製作一個一鍵安裝程式？

在 Mac 上安裝

注意：您只能在配備 M1 或 M2 (Mx) Apple 晶片處理器的 Mac 電腦上執行 SwarmUI。

• 打開終端機。

• 確保您的brew包已使用brew update進行更新。

• 使用brew doctor驗證您的brew安裝。您不應在命令輸出中看到任何錯誤。

• 為 macOS 安裝 .NET： brew install dotnet 。

• 如果您沒有Python，請安裝它： brew install [email protected]和brew install virtualenv

• 將目錄 ( cd ) 變更為要安裝 SwarmUI 的資料夾。

• 複製 SwarmUI GitHub 儲存庫： git clone https://github.com/mcmonkeyprojects/SwarmUI 。

• cd SwarmUI並執行安裝腳本： ./launch-macos.sh 。

安裝立即開始並從互聯網下載穩定擴散模型。根據您的網路連線情況，這可能需要幾分鐘的時間。等待您的 Web 瀏覽器開啟 SwarmUI 視窗。

在 SwarmUI 安裝過程中，系統會提示您選擇要使用的後端類型。對於配備 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到要安裝的目錄

• 運行外殼命令：

• git clone https://github.com/mcmonkeyprojects/SwarmUI

• cd SwarmUI

• ./launch-docker.sh

• 開啟瀏覽器訪問localhost:7801

• 請注意，它將轉發Models和Output目錄，並將Data和dlbackend安裝為獨立的持久性磁碟區。

文件

請參閱文件資料夾。

動機

「Swarm」名稱參考了 UI 的原始關鍵功能：使 GPU「群組」能夠同時為同一用戶生成映像（特別是對於大型網格生成）。這只是 Swarm 名稱的靈感來源，而不是 Swarm 的全部。

SwarmUI 的總體目標是成為穩定擴散的全功能一站式商店。

有關技術選擇的動機，請參閱動機文件。

合法的

這個項目：

• 嵌入 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) for IP Adapter - Face支持

• 使用 JSON.NET (MIT)、FreneticUtilities (MIT)、LiteDB (MIT)、ImageSharp（開源分割許可證下的 Apache2）

• 嵌入來自 BootStrap (MIT)、Select2 (MIT)、JQuery (MIT)、exifr (MIT) 的 Web 資源副本。

• 可用於安裝一些自訂節點包，這些節點包在安裝前對任何非純 FOSS 許可證都有單獨的許可證通知。

• 支援用戶建置的擴展，這些擴展可能有自己的許可證或法律條件。

SwarmUI 本身遵循 MIT 許可證，但某些用途可能會受到上面列出的連接項目的 GPL 變體許可證的影響，請注意，使用的任何模型都有自己的許可證。

以前的許可證

（適用於 2024 年 6 月之前的更新）

麻省理工學院許可證 (MIT) 版權所有 (c) 2024 Stability AI

執照

麻省理工學院許可證 (MIT)

版權所有 (c) 2024 亞歷克斯“mcmonkey”古德溫

特此免費授予任何獲得本軟體和相關文件文件（「軟體」）副本的人不受限制地使用本軟體，包括但不限於使用、複製、修改、合併的權利、發布、分發、再授權和/或銷售軟體的副本，並允許向其提供軟體的人員這樣做，但須滿足以下條件：

上述版權聲明和本授權聲明應包含在本軟體的所有副本或主要部分中。

本軟體以「現況」提供，不提供任何明示或暗示的保證，包括但不限於適銷性、特定用途的適用性和不侵權的保證。 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE軟體.