Stable Diffusion web UI
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
AUTOMATIC1111 5ef669de08 Merge branch 'release_candidate' 1 month ago
.github update bug report template to include sysinfo and not include all other fields that are already covered by sysinfo 1 month ago
configs disable EMA weights for instructpix2pix model, whcih should get memory usage as well as image quality to what it was before d2ac95fa7b 8 months ago
embeddings add embeddings dir 1 year ago
extensions delete the submodule dir (why do you keep doing this) 11 months ago
extensions-builtin Merge pull request #12838 from bluelovers/pr/file-metadata-path-001 1 month ago
html hide cards for networks of incompatible stable diffusion version in Lora extra networks interface 2 months ago
javascript get progressbar to display correctly in extensions tab 1 month ago
localizations Remove old localizations from the main repo. 11 months ago
models Add support for the Variations models (unclip-h and unclip-l) 6 months ago
modules Merge pull request #12876 from ljleb/fix-re 1 month ago
scripts Merge pull request #12818 from catboxanon/sgm 1 month ago
test avoid importing gradio in tests because it spams warnings 2 months ago
textual_inversion_templates hypernetwork training mk1 12 months ago
.eslintignore Add basic ESLint configuration for formatting 5 months ago
.eslintrc.js make resize handle available to extensions 1 month ago
.git-blame-ignore-revs Add .git-blame-ignore-revs 4 months ago
.gitignore Overhaul tests to use py.test 4 months ago
.pylintrc Add basic Pylint to catch syntax errors on PRs 12 months ago add information about Restore faces and Tiling into the changelog 1 month ago
CITATION.cff citation mk2 1 month ago
CODEOWNERS remove localization people from CODEOWNERS add a note 11 months ago
LICENSE.txt add license file 9 months ago Update with Intel install instructions 1 month ago
environment-wsl2.yaml update xformers 6 months ago add --dump-sysinfo, a cmd arg to dump limited sysinfo file at startup 1 month ago
package.json Add basic ESLint configuration for formatting 5 months ago
pyproject.toml Overhaul tests to use py.test 4 months ago
requirements-test.txt Overhaul tests to use py.test 4 months ago
requirements.txt update gradio to 3.41.2 1 month ago
requirements_versions.txt update gradio to 3.41.2 1 month ago
screenshot.png new screenshot 9 months ago
script.js Frontend: only look at top-level tabs, not nested tabs 4 months ago
style.css get progressbar to display correctly in extensions tab 1 month ago Mac k-diffusion workarounds are no longer needed 2 months ago
webui-user.bat revert change to webui-user.bat 10 months ago Vendor in the single module used from taming_transformers; remove taming_transformers dependency 4 months ago
webui.bat Restart: only do restart if running via the wrapper script 4 months ago Merge pull request #12814 from AUTOMATIC1111/non-local-condition 1 month ago Merge pull request #12704 from fraz0815/master 1 month ago

Stable Diffusion web UI

A browser interface based on Gradio library for Stable Diffusion.


Detailed feature showcase with images:

  • Original txt2img and img2img modes
  • One click install and run script (but you still must install python and git)
  • Outpainting
  • Inpainting
  • Color Sketch
  • Prompt Matrix
  • Stable Diffusion Upscale
  • Attention, specify parts of text that the model should pay more attention to
    • a man in a ((tuxedo)) - will pay more attention to tuxedo
    • a man in a (tuxedo:1.21) - alternative syntax
    • select text and press Ctrl+Up or Ctrl+Down (or Command+Up or Command+Down if you're on a MacOS) to automatically adjust attention to selected text (code contributed by anonymous user)
  • Loopback, run img2img processing multiple times
  • X/Y/Z plot, a way to draw a 3 dimensional plot of images with different parameters
  • Textual Inversion
    • have as many embeddings as you want and use any names you like for them
    • use multiple embeddings with different numbers of vectors per token
    • works with half precision floating point numbers
    • train embeddings on 8GB (also reports of 6GB working)
  • Extras tab with:
    • GFPGAN, neural network that fixes faces
    • CodeFormer, face restoration tool as an alternative to GFPGAN
    • RealESRGAN, neural network upscaler
    • ESRGAN, neural network upscaler with a lot of third party models
    • SwinIR and Swin2SR (see here), neural network upscalers
    • LDSR, Latent diffusion super resolution upscaling
  • Resizing aspect ratio options
  • Sampling method selection
    • Adjust sampler eta values (noise multiplier)
    • More advanced noise setting options
  • Interrupt processing at any time
  • 4GB video card support (also reports of 2GB working)
  • Correct seeds for batches
  • Live prompt token length validation
  • Generation parameters
    • parameters you used to generate images are saved with that image
    • in PNG chunks for PNG, in EXIF for JPEG
    • can drag the image to PNG info tab to restore generation parameters and automatically copy them into UI
    • can be disabled in settings
    • drag and drop an image/text-parameters to promptbox
  • Read Generation Parameters Button, loads parameters in promptbox to UI
  • Settings page
  • Running arbitrary python code from UI (must run with --allow-code to enable)
  • Mouseover hints for most UI elements
  • Possible to change defaults/mix/max/step values for UI elements via text config
  • Tiling support, a checkbox to create images that can be tiled like textures
  • Progress bar and live image generation preview
    • Can use a separate neural network to produce previews with almost none VRAM or compute requirement
  • Negative prompt, an extra text field that allows you to list what you don't want to see in generated image
  • Styles, a way to save part of prompt and easily apply them via dropdown later
  • Variations, a way to generate same image but with tiny differences
  • Seed resizing, a way to generate same image but at slightly different resolution
  • CLIP interrogator, a button that tries to guess prompt from an image
  • Prompt Editing, a way to change prompt mid-generation, say to start making a watermelon and switch to anime girl midway
  • Batch Processing, process a group of files using img2img
  • Img2img Alternative, reverse Euler method of cross attention control
  • Highres Fix, a convenience option to produce high resolution pictures in one click without usual distortions
  • Reloading checkpoints on the fly
  • Checkpoint Merger, a tab that allows you to merge up to 3 checkpoints into one
  • Custom scripts with many extensions from community
  • Composable-Diffusion, a way to use multiple prompts at once
    • separate prompts using uppercase AND
    • also supports weights for prompts: a cat :1.2 AND a dog AND a penguin :2.2
  • No token limit for prompts (original stable diffusion lets you use up to 75 tokens)
  • DeepDanbooru integration, creates danbooru style tags for anime prompts
  • xformers, major speed increase for select cards: (add --xformers to commandline args)
  • via extension: History tab: view, direct and delete images conveniently within the UI
  • Generate forever option
  • Training tab
    • hypernetworks and embeddings options
    • Preprocessing images: cropping, mirroring, autotagging using BLIP or deepdanbooru (for anime)
  • Clip skip
  • Hypernetworks
  • Loras (same as Hypernetworks but more pretty)
  • A separate UI where you can choose, with preview, which embeddings, hypernetworks or Loras to add to your prompt
  • Can select to load a different VAE from settings screen
  • Estimated completion time in progress bar
  • API
  • Support for dedicated inpainting model by RunwayML
  • via extension: Aesthetic Gradients, a way to generate images with a specific aesthetic by using clip images embeds (implementation of
  • Stable Diffusion 2.0 support - see wiki for instructions
  • Alt-Diffusion support - see wiki for instructions
  • Now without any bad letters!
  • Load checkpoints in safetensors format
  • Eased resolution restriction: generated image's dimension must be a multiple of 8 rather than 64
  • Now with a license!
  • Reorder elements in the UI from settings screen

Installation and Running

Make sure the required dependencies are met and follow the instructions available for:

Alternatively, use online services (like Google Colab):

Installation on Windows 10/11 with NVidia-GPUs using release package

  1. Download from v1.0.0-pre and extract it's contents.
  2. Run update.bat.
  3. Run run.bat.

For more details see Install-and-Run-on-NVidia-GPUs

Automatic Installation on Windows

  1. Install Python 3.10.6 (Newer version of Python does not support torch), checking "Add Python to PATH".
  2. Install git.
  3. Download the stable-diffusion-webui repository, for example by running git clone
  4. Run webui-user.bat from Windows Explorer as normal, non-administrator, user.

Automatic Installation on Linux

  1. Install the dependencies:
# Debian-based:
sudo apt install wget git python3 python3-venv libgl1 libglib2.0-0
# Red Hat-based:
sudo dnf install wget git python3
# Arch-based:
sudo pacman -S wget git python3
  1. Navigate to the directory you would like the webui to be installed and execute the following command:
wget -q
  1. Run
  2. Check for options.

Installation on Apple Silicon

Find the instructions here.


Here's how to add code to this repo: Contributing


The documentation was moved from this README over to the project's wiki.

For the purposes of getting Google and other search engines to crawl the wiki, here's a link to the (not for humans) crawlable wiki.


Licenses for borrowed code can be found in Settings -> Licenses screen, and also in html/licenses.html file.