How luxxxonly/stable-diffusion-webui works
Stable Diffusion web UI is a Gradio application for generating and editing images, with an API and extensible model tooling. Its main workflow takes a user request through a generation entry point, model and sampler configuration, then produces images with generation metadata. The README also documents editing, training, restoration, upscaling, and model-adaptation capabilities. Edges use README statements or SOURCE INDEX references; unsampled subsystems are represented where documented, without asserting unshown internal calls.
Main entry points: processing.py Generation Processing · ui.py Gradio UI · sd_hijack.py Model Integration · postprocessing.py Image Postprocessing
Components 22
User Experience
- Gradio UI
modules/ui.py - HTTP API
modules/api/api.py - Script Extensions
modules/scripts.py - Settings and State
modules/shared.py
Generation Runtime
- txt2img / img2img
modules/txt2img.py - Generation Processing
modules/processing.py - Prompt Parsing
modules/prompt_parser.py - Sampler Selection
modules/sd_samplers.py - Image Output
modules/images.py - Generation Metadata
modules/infotext_utils.py
Models and Conditioning
- Checkpoint Loading
modules/sd_models.py - Model Integration
modules/sd_hijack.py - VAE Management
modules/sd_vae.py - Device Support
modules/devices.py - Textual Inversion
modules/textual_inversion/textual_inversion.py - Hypernetworks
modules/hypernetworks/hypernetwork.py - LoRA Networks
extensions-builtin/Lora/networks.py
Extended Capabilities
- Image Postprocessing
modules/postprocessing.py - Upscalers
modules/upscaler.py - Face Restoration
modules/face_restoration.py - Embedding Training
modules/textual_inversion/textual_inversion.py
Other components
- User
Connections 23
- User → Gradio UI: uses
README.md - User → HTTP API: requests generation
README.md - Gradio UI → txt2img / img2img: selects mode
README.md - HTTP API → Generation Processing: serves generation
modules/api/api.py - txt2img / img2img → Generation Processing: starts processing
- Generation Processing → Prompt Parsing: uses prompt parsing
modules/processing.py - Generation Processing → Sampler Selection: uses samplers
modules/processing.py - Generation Processing → Checkpoint Loading: uses model loading
modules/processing.py - Generation Processing → Model Integration: uses model hooks
modules/processing.py - Generation Processing → Device Support: uses devices
modules/processing.py - Generation Processing → VAE Management: uses VAE
modules/processing.py - Generation Processing → Image Output: produces images
modules/processing.py - Image Output → Generation Metadata: stores parameters
README.md - Model Integration → Textual Inversion: integrates embeddings
modules/sd_hijack.py - Model Integration → Hypernetworks: integrates hypernetworks
modules/sd_hijack.py - Generation Processing → LoRA Networks: supports LoRA
modules/processing.py - Script Extensions → Generation Processing: extends processing
modules/scripts.py - Gradio UI → Settings and State: exposes settings
modules/ui.py - User → Image Postprocessing: requests extras
README.md - Image Postprocessing → Upscalers: offers upscaling
README.md - Image Postprocessing → Face Restoration: offers restoration
README.md - User → Embedding Training: trains embeddings
README.md - Embedding Training → Textual Inversion: creates embeddings
modules/textual_inversion/textual_inversion.py