# stability-ai/stableswarmui architecture

> Architecture diagram of the GitHub repository stability-ai/stableswarmui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/stability-ai/stableswarmui
- Repository: https://github.com/stability-ai/stableswarmui

## Overview

StableSwarmUI is a modular Stable Diffusion web UI. A user works in the browser’s Generate interface, submits generation requests through the web API, and receives generated images; model and backend management support that flow. The README also highlights unrestricted Comfy workflows and power tools such as grid generation and image editing. The graph preserves those documented branches, but sampled excerpts do not establish every UI route or extension registration, so uncertain connections are omitted.

Main entry points: [`src/Core/Program.cs`](https://github.com/stability-ai/stableswarmui/blob/master/src/Core/Program.cs) (Application startup), [`src/Text2Image/T2IEngine.cs`](https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IEngine.cs) (Generation engine), [`src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs`](https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs) (Image batch tool), [`src/Backends/BackendHandler.cs`](https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/BackendHandler.cs) (Backend manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Web interaction"]
  node_browser["Web UI<br/>[main.js]"]
  node_generate_ui["Generate interface<br/>[generatehandler.js]"]
  node_web_server["Web server<br/>[WebServer.cs]"]
  node_api["API features"]
  node_t2i_api["Generation API<br/>[T2IAPI.cs]"]
end

subgraph group_generation["Generation domain"]
  node_engine["Generation engine<br/>[T2IEngine.cs]"]
  node_params["Parameter inputs<br/>[T2IParamInput.cs]"]
  node_param_types["Parameter types<br/>[T2IParamTypes.cs]"]
  node_models["Model catalog<br/>[T2IModelHandler.cs]"]
  node_sessions["Sessions and users<br/>[Session.cs]"]
  node_image["Image handling<br/>[Image.cs]"]
end

subgraph group_backends["Inference backends"]
  node_backend_handler["Backend manager<br/>[BackendHandler.cs]"]
  node_backend_base["Backend interface"]
  node_network_utils["Backend networking"]
  node_comfy_workflow["Comfy workflows"]
  node_backend_integrations["Backend integrations"]
end

subgraph group_extensions["Power tools"]
  node_grid["Grid generator<br/>[GridGenCore.cs]"]
  node_image_tools["Image batch tool"]
  node_scorers["Image scorers<br/>[scorer_engine.py]"]
end

subgraph group_runtime["Runtime services"]
  node_runtime["Application startup<br/>[Program.cs]"]
  node_settings["Settings<br/>[Settings.cs]"]
  node_logs["Logging<br/>[Logs.cs]"]
  node_utilities["Shared utilities<br/>[Utilities.cs]"]
  node_languages["Language support<br/>[LanguagesHelper.cs]"]
end

node_user(("User"))

node_user -->|"uses"| node_browser
node_browser -->|"opens"| node_generate_ui
node_user -->|"uses"| node_comfy_workflow
node_user -->|"uses"| node_grid
node_user -->|"uses"| node_image_tools
node_runtime -->|"starts"| node_web_server
node_runtime -->|"loads"| node_settings
node_runtime -->|"initializes"| node_backend_handler
node_runtime -->|"initializes"| node_models
node_web_server -->|"serves"| node_api
node_api -->|"registers"| node_t2i_api
node_t2i_api -->|"invokes"| node_engine
node_t2i_api -->|"uses"| node_sessions
node_engine -->|"reads"| node_params
node_params -->|"uses"| node_param_types
node_engine -->|"uses"| node_models
node_engine -->|"dispatches"| node_backend_handler
node_engine -->|"uses"| node_sessions
node_engine -->|"processes"| node_image
node_backend_handler -->|"manages"| node_backend_base
node_backend_base -->|"uses"| node_image
node_backend_base -->|"uses"| node_params
node_backend_handler -->|"loads"| node_backend_integrations
node_comfy_workflow -->|"uses"| node_param_types
node_comfy_workflow -->|"uses"| node_backend_integrations
node_grid -->|"uses"| node_param_types
node_image_tools -->|"uses"| node_engine
node_image_tools -->|"uses"| node_image
node_image_tools -->|"registers"| node_api
node_runtime -->|"initializes"| node_logs
node_runtime -->|"uses"| node_utilities
node_runtime -->|"initializes"| node_languages
node_network_utils -->|"uses"| node_utilities
node_backend_integrations -.->|"uses"| node_network_utils
node_scorers -.->|"scores"| node_image

click node_browser "https://github.com/stability-ai/stableswarmui/blob/master/src/wwwroot/js/genpage/main.js"
click node_generate_ui "https://github.com/stability-ai/stableswarmui/blob/master/src/wwwroot/js/genpage/generatehandler.js"
click node_web_server "https://github.com/stability-ai/stableswarmui/blob/master/src/Core/WebServer.cs"
click node_api "https://github.com/stability-ai/stableswarmui/blob/master/src/WebAPI/BasicAPIFeatures.cs"
click node_t2i_api "https://github.com/stability-ai/stableswarmui/blob/master/src/WebAPI/T2IAPI.cs"
click node_engine "https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IEngine.cs"
click node_params "https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IParamInput.cs"
click node_param_types "https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IParamTypes.cs"
click node_models "https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IModelHandler.cs"
click node_sessions "https://github.com/stability-ai/stableswarmui/blob/master/src/Accounts/Session.cs"
click node_image "https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/Image.cs"
click node_backend_handler "https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/BackendHandler.cs"
click node_backend_base "https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/AbstractT2IBackend.cs"
click node_network_utils "https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/NetworkBackendUtils.cs"
click node_comfy_workflow "https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/ComfyUIBackend/WorkflowGeneratorSteps.cs"
click node_backend_integrations "https://github.com/stability-ai/stableswarmui/tree/master/src/BuiltinExtensions"
click node_grid "https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/GridGenerator/GridGenCore.cs"
click node_image_tools "https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs"
click node_scorers "https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/Scorers/scorer_engine.py"
click node_runtime "https://github.com/stability-ai/stableswarmui/blob/master/src/Core/Program.cs"
click node_settings "https://github.com/stability-ai/stableswarmui/blob/master/src/Core/Settings.cs"
click node_logs "https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/Logs.cs"
click node_utilities "https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/Utilities.cs"
click node_languages "https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/LanguagesHelper.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser,node_generate_ui,node_web_server,node_api,node_t2i_api,node_user toneBlue
class node_engine,node_params,node_param_types,node_models,node_sessions,node_image toneAmber
class node_backend_handler,node_backend_base,node_network_utils,node_comfy_workflow,node_backend_integrations toneMint
class node_grid,node_image_tools,node_scorers toneRose
class node_runtime,node_settings,node_logs,node_utilities,node_languages toneIndigo
```

## Components

### Web interaction

- [Web UI](https://github.com/stability-ai/stableswarmui/blob/master/src/wwwroot/js/genpage/main.js): `src/wwwroot/js/genpage/main.js`
- [Generate interface](https://github.com/stability-ai/stableswarmui/blob/master/src/wwwroot/js/genpage/generatehandler.js): `src/wwwroot/js/genpage/generatehandler.js`
- [Web server](https://github.com/stability-ai/stableswarmui/blob/master/src/Core/WebServer.cs): `src/Core/WebServer.cs`
- [API features](https://github.com/stability-ai/stableswarmui/blob/master/src/WebAPI/BasicAPIFeatures.cs): `src/WebAPI/BasicAPIFeatures.cs`
- [Generation API](https://github.com/stability-ai/stableswarmui/blob/master/src/WebAPI/T2IAPI.cs): `src/WebAPI/T2IAPI.cs`

### Generation domain

- [Generation engine](https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IEngine.cs): `src/Text2Image/T2IEngine.cs`
- [Parameter inputs](https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IParamInput.cs): `src/Text2Image/T2IParamInput.cs`
- [Parameter types](https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IParamTypes.cs): `src/Text2Image/T2IParamTypes.cs`
- [Model catalog](https://github.com/stability-ai/stableswarmui/blob/master/src/Text2Image/T2IModelHandler.cs): `src/Text2Image/T2IModelHandler.cs`
- [Sessions and users](https://github.com/stability-ai/stableswarmui/blob/master/src/Accounts/Session.cs): `src/Accounts/Session.cs`
- [Image handling](https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/Image.cs): `src/Utils/Image.cs`

### Inference backends

- [Backend manager](https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/BackendHandler.cs): `src/Backends/BackendHandler.cs`
- [Backend interface](https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/AbstractT2IBackend.cs): `src/Backends/AbstractT2IBackend.cs`
- [Backend networking](https://github.com/stability-ai/stableswarmui/blob/master/src/Backends/NetworkBackendUtils.cs): `src/Backends/NetworkBackendUtils.cs`
- [Comfy workflows](https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/ComfyUIBackend/WorkflowGeneratorSteps.cs): `src/BuiltinExtensions/ComfyUIBackend/WorkflowGeneratorSteps.cs`
- [Backend integrations](https://github.com/stability-ai/stableswarmui/tree/master/src/BuiltinExtensions): `src/BuiltinExtensions`

### Power tools

- [Grid generator](https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/GridGenerator/GridGenCore.cs): `src/BuiltinExtensions/GridGenerator/GridGenCore.cs`
- [Image batch tool](https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs): `src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs`
- [Image scorers](https://github.com/stability-ai/stableswarmui/blob/master/src/BuiltinExtensions/Scorers/scorer_engine.py): `src/BuiltinExtensions/Scorers/scorer_engine.py`

### Runtime services

- [Application startup](https://github.com/stability-ai/stableswarmui/blob/master/src/Core/Program.cs): `src/Core/Program.cs`
- [Settings](https://github.com/stability-ai/stableswarmui/blob/master/src/Core/Settings.cs): `src/Core/Settings.cs`
- [Logging](https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/Logs.cs): `src/Utils/Logs.cs`
- [Shared utilities](https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/Utilities.cs): `src/Utils/Utilities.cs`
- [Language support](https://github.com/stability-ai/stableswarmui/blob/master/src/Utils/LanguagesHelper.cs): `src/Utils/LanguagesHelper.cs`

### Other components

- **User**

## Connections

- User → Web UI: uses (evidence: `README.md`)
- Web UI → Generate interface: opens (evidence: `README.md`)
- User → Comfy workflows: uses (evidence: `README.md`)
- User → Grid generator: uses (evidence: `README.md`)
- User → Image batch tool: uses (evidence: `README.md`)
- Application startup → Web server: starts (evidence: `src/Core/Program.cs`)
- Application startup → Settings: loads (evidence: `src/Core/Program.cs`)
- Application startup → Backend manager: initializes (evidence: `src/Core/Program.cs`)
- Application startup → Model catalog: initializes (evidence: `src/Core/Program.cs`)
- Web server → API features: serves (evidence: `src/Core/WebServer.cs`)
- API features → Generation API: registers (evidence: `src/WebAPI/BasicAPIFeatures.cs`)
- Generation API → Generation engine: invokes (evidence: `src/WebAPI/T2IAPI.cs`)
- Generation API → Sessions and users: uses (evidence: `src/WebAPI/T2IAPI.cs`)
- Generation engine → Parameter inputs: reads (evidence: `src/Text2Image/T2IEngine.cs`)
- Parameter inputs → Parameter types: uses (evidence: `src/Text2Image/T2IParamInput.cs`)
- Generation engine → Model catalog: uses (evidence: `src/Text2Image/T2IEngine.cs`)
- Generation engine → Backend manager: dispatches (evidence: `src/Text2Image/T2IEngine.cs`)
- Generation engine → Sessions and users: uses (evidence: `src/Text2Image/T2IEngine.cs`)
- Generation engine → Image handling: processes (evidence: `src/Text2Image/T2IEngine.cs`)
- Backend manager → Backend interface: manages (evidence: `src/Backends/BackendHandler.cs`)
- Backend interface → Image handling: uses (evidence: `src/Backends/AbstractT2IBackend.cs`)
- Backend interface → Parameter inputs: uses (evidence: `src/Backends/AbstractT2IBackend.cs`)
- Backend manager → Backend integrations: loads (evidence: `src/Backends/BackendHandler.cs`)
- Comfy workflows → Parameter types: uses (evidence: `src/BuiltinExtensions/ComfyUIBackend/WorkflowGeneratorSteps.cs`)
- Comfy workflows → Backend integrations: uses (evidence: `src/BuiltinExtensions/ComfyUIBackend/WorkflowGeneratorSteps.cs`)
- Grid generator → Parameter types: uses (evidence: `src/BuiltinExtensions/GridGenerator/GridGenCore.cs`)
- Image batch tool → Generation engine: uses (evidence: `src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs`)
- Image batch tool → Image handling: uses (evidence: `src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs`)
- Image batch tool → API features: registers (evidence: `src/BuiltinExtensions/ImageBatchTool/ImageBatchToolExtension.cs`)
- Application startup → Logging: initializes (evidence: `src/Core/Program.cs`)
- Application startup → Shared utilities: uses (evidence: `src/Core/Program.cs`)
- Application startup → Language support: initializes (evidence: `src/Core/Program.cs`)
- Backend networking → Shared utilities: uses (evidence: `src/Backends/NetworkBackendUtils.cs`)
- Backend integrations → Backend networking: uses (evidence: `src/BuiltinExtensions/StabilityAPI/StabilityAPIBackend.cs`)
- Image scorers → Image handling: scores
