# umittadelen/stablediffusioneasyui architecture

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

- Interactive diagram: https://gitdiagram.com/umittadelen/stablediffusioneasyui
- Repository: https://github.com/umittadelen/stablediffusioneasyui

## Overview

EasyUI is a local text-to-image generation application: users configure a model and generation parameters in its web interface, submit a request, and monitor generated images in a live gallery. The Flask application owns generation, progress/status, image serving, and model-management routes; specialized tools supply schedulers, depth/normal processing, safety scoring, and Civitai downloads. The README documents broader capabilities including img2img, ControlNet, LoRAs, metadata, and model management. Several client/server and feature links are documented rather than visible in the sampled excerpts, so those relationships are marked accordingly.

Main entry points: [`app.py`](https://github.com/umittadelen/stablediffusioneasyui/blob/main/app.py) (Flask application), [`extension_loader.py`](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extension_loader.py) (Extension loader), [`static/js/main.js`](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/main.js) (Generation UI), [`static/js/models.js`](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/models.js) (Model controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Web interface"]
  node_web_ui["Generation UI<br/>[main.js]"]
  node_model_ui["Model controls<br/>[models.js]"]
  node_lora_ui["LoRA controls<br/>[loras.js]"]
  node_settings_ui["Settings UI<br/>[settings.js]"]
  node_theme_ui["Theme UI<br/>[theme.js]"]
  node_main_page["Generation page<br/>[index.html]"]
  node_model_page["Model pages<br/>[models.html]"]
  node_loras_page["LoRA page<br/>[loras.html]"]
  node_settings_page["Settings page<br/>[settings.html]"]
end

subgraph group_generation["Generation runtime"]
  node_flask_app["Flask application<br/>[app.py]"]
  node_image_state[("Image cache and files<br/>[app.py]")]
  node_scheduler["Scheduler variants<br/>[Schedulers.py]"]
  node_depthpro["Depth estimation<br/>[DepthPro.py]"]
  node_beit_depth["BEiT depth"]
  node_normal_map["Normal maps<br/>[NormalMap.py]"]
  node_nsfw["NSFW scoring<br/>[NSFWClassifier.py]"]
end

subgraph group_models["Model operations"]
  node_civitai["Civitai downloads"]
end

subgraph group_extensions["Extension system"]
  node_extension_loader["Extension loader"]
  node_extension_manager["Extension manager<br/>[__init__.py]"]
  node_favorites[("Favorites<br/>[__init__.py]")]
  node_history["Image history<br/>[__init__.py]"]
  node_booru_tags["Booru tags<br/>[__init__.py]"]
  node_terminal["Terminal extension<br/>[__init__.py]"]
  node_theme_extension["Theme customizer<br/>[__init__.py]"]
  node_example_extension["Example extension<br/>[__init__.py]"]
end

node_user(("User"))
node_civitai_service(("Civitai service"))

node_user -->|"configures"| node_web_ui
node_web_ui -.->|"submits requests"| node_flask_app
node_flask_app -->|"updates images"| node_image_state
node_flask_app -->|"imports scheduler"| node_scheduler
node_flask_app -->|"imports depth tool"| node_depthpro
node_flask_app -->|"imports depth tool"| node_beit_depth
node_flask_app -->|"imports map tool"| node_normal_map
node_flask_app -->|"imports scorer"| node_nsfw
node_flask_app -->|"loads extensions"| node_extension_loader
node_flask_app -->|"uses downloads"| node_civitai
node_civitai -->|"fetches model data"| node_civitai_service
node_web_ui -.->|"renders controls"| node_main_page
node_model_ui -.->|"manages models"| node_model_page
node_lora_ui -.->|"manages LoRAs"| node_loras_page
node_settings_ui -.->|"configures settings"| node_settings_page
node_user -.->|"chooses models"| node_model_ui
node_user -.->|"chooses LoRAs"| node_lora_ui
node_user -.->|"sets preferences"| node_settings_ui
node_flask_app -.->|"serves model management"| node_model_ui
node_flask_app -.->|"serves generation status"| node_web_ui
node_extension_loader -->|"initializes extension"| node_extension_manager
node_extension_loader -.->|"initializes extension"| node_favorites
node_extension_loader -.->|"initializes extension"| node_history
node_extension_loader -.->|"initializes extension"| node_booru_tags
node_extension_loader -.->|"initializes extension"| node_terminal
node_extension_loader -.->|"initializes extension"| node_theme_extension
node_extension_loader -.->|"initializes extension"| node_example_extension
node_favorites -.->|"copies generated images"| node_image_state

click node_web_ui "https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/main.js"
click node_model_ui "https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/models.js"
click node_lora_ui "https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/loras.js"
click node_settings_ui "https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/settings.js"
click node_theme_ui "https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/theme.js"
click node_main_page "https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/index.html"
click node_model_page "https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/models.html"
click node_loras_page "https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/loras.html"
click node_settings_page "https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/settings.html"
click node_flask_app "https://github.com/umittadelen/stablediffusioneasyui/blob/main/app.py"
click node_image_state "https://github.com/umittadelen/stablediffusioneasyui/blob/main/app.py"
click node_scheduler "https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/Schedulers.py"
click node_depthpro "https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/DepthPro.py"
click node_beit_depth "https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/BEiTDepthEstimation.py"
click node_normal_map "https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/NormalMap.py"
click node_nsfw "https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/NSFWClassifier.py"
click node_civitai "https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/downloadFromCivitai.py"
click node_extension_loader "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extension_loader.py"
click node_extension_manager "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/extension_manager/__init__.py"
click node_favorites "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/favorites/__init__.py"
click node_history "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/image_history/__init__.py"
click node_booru_tags "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/booru_tags/__init__.py"
click node_terminal "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/terminal/__init__.py"
click node_theme_extension "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/theme_customizer/__init__.py"
click node_example_extension "https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/example_extension/__init__.py"

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_web_ui,node_model_ui,node_lora_ui,node_settings_ui,node_theme_ui,node_main_page,node_model_page,node_loras_page,node_settings_page,node_user toneBlue
class node_flask_app,node_image_state,node_scheduler,node_depthpro,node_beit_depth,node_normal_map,node_nsfw toneAmber
class node_civitai toneMint
class node_extension_loader,node_extension_manager,node_favorites,node_history,node_booru_tags,node_terminal,node_theme_extension,node_example_extension toneRose
class node_civitai_service toneIndigo
```

## Components

### Web interface

- [Generation UI](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/main.js): `static/js/main.js`
- [Model controls](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/models.js): `static/js/models.js`
- [LoRA controls](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/loras.js): `static/js/loras.js`
- [Settings UI](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/settings.js): `static/js/settings.js`
- [Theme UI](https://github.com/umittadelen/stablediffusioneasyui/blob/main/static/js/theme.js): `static/js/theme.js`
- [Generation page](https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/index.html): `templates/index.html`
- [Model pages](https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/models.html): `templates/models.html`
- [LoRA page](https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/loras.html): `templates/loras.html`
- [Settings page](https://github.com/umittadelen/stablediffusioneasyui/blob/main/templates/settings.html): `templates/settings.html`

### Generation runtime

- [Flask application](https://github.com/umittadelen/stablediffusioneasyui/blob/main/app.py): `app.py`
- [Image cache and files](https://github.com/umittadelen/stablediffusioneasyui/blob/main/app.py): `app.py`
- [Scheduler variants](https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/Schedulers.py): `tools/Schedulers.py`
- [Depth estimation](https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/DepthPro.py): `tools/DepthPro.py`
- [BEiT depth](https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/BEiTDepthEstimation.py): `tools/BEiTDepthEstimation.py`
- [Normal maps](https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/NormalMap.py): `tools/NormalMap.py`
- [NSFW scoring](https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/NSFWClassifier.py): `tools/NSFWClassifier.py`

### Model operations

- [Civitai downloads](https://github.com/umittadelen/stablediffusioneasyui/blob/main/tools/downloadFromCivitai.py): `tools/downloadFromCivitai.py`

### Extension system

- [Extension loader](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extension_loader.py): `extension_loader.py`
- [Extension manager](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/extension_manager/__init__.py): `extensions/extension_manager/__init__.py`
- [Favorites](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/favorites/__init__.py): `extensions/favorites/__init__.py`
- [Image history](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/image_history/__init__.py): `extensions/image_history/__init__.py`
- [Booru tags](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/booru_tags/__init__.py): `extensions/booru_tags/__init__.py`
- [Terminal extension](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/terminal/__init__.py): `extensions/terminal/__init__.py`
- [Theme customizer](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/theme_customizer/__init__.py): `extensions/theme_customizer/__init__.py`
- [Example extension](https://github.com/umittadelen/stablediffusioneasyui/blob/main/extensions/example_extension/__init__.py): `extensions/example_extension/__init__.py`

### Other components

- **User**
- **Civitai service**

## Connections

- User → Generation UI: configures (evidence: `README.md`)
- Generation UI → Flask application: submits requests (evidence: `README.md`)
- Flask application → Image cache and files: updates images (evidence: `app.py`)
- Flask application → Scheduler variants: imports scheduler (evidence: `app.py`)
- Flask application → Depth estimation: imports depth tool (evidence: `app.py`)
- Flask application → BEiT depth: imports depth tool (evidence: `app.py`)
- Flask application → Normal maps: imports map tool (evidence: `app.py`)
- Flask application → NSFW scoring: imports scorer (evidence: `app.py`)
- Flask application → Extension loader: loads extensions (evidence: `app.py`)
- Flask application → Civitai downloads: uses downloads (evidence: `app.py`)
- Civitai downloads → Civitai service: fetches model data (evidence: `tools/downloadFromCivitai.py`)
- Generation UI → Generation page: renders controls (evidence: `README.md`)
- Model controls → Model pages: manages models (evidence: `README.md`)
- LoRA controls → LoRA page: manages LoRAs (evidence: `README.md`)
- Settings UI → Settings page: configures settings (evidence: `README.md`)
- User → Model controls: chooses models (evidence: `README.md`)
- User → LoRA controls: chooses LoRAs (evidence: `README.md`)
- User → Settings UI: sets preferences (evidence: `README.md`)
- Flask application → Model controls: serves model management (evidence: `README.md`)
- Flask application → Generation UI: serves generation status (evidence: `README.md`)
- Extension loader → Extension manager: initializes extension (evidence: `extensions/extension_manager/__init__.py`)
- Extension loader → Favorites: initializes extension (evidence: `extensions/favorites/__init__.py`)
- Extension loader → Image history: initializes extension
- Extension loader → Booru tags: initializes extension
- Extension loader → Terminal extension: initializes extension
- Extension loader → Theme customizer: initializes extension
- Extension loader → Example extension: initializes extension
- Favorites → Image cache and files: copies generated images
