AUTOMATIC1111: install Stable Diffusion WebUI (2026)
AUTOMATIC1111 (A1111) is the free, open-source web interface, licensed under AGPL-3.0, that popularized Stable Diffusion on PC. It installs Python 3.10 and Git through a single script, opens in the browser at http://127.0.0.1:7860, and supports Stable Diffusion 1.5 and SDXL. It does not support Flux, and its latest version, 1.10.1, dates from February 2025; for a new installation, a Forge fork or ComfyUI is often a better choice.
AUTOMATIC1111, often abbreviated as A1111, is the free, open-source web interface that made Stable Diffusion accessible without writing a single line of Python. Its full name is Stable Diffusion WebUI. It runs image models on your machine, in the browser, with no account or subscription. As of September 28, 2026, it still works very well with Stable Diffusion 1.5 and SDXL, but its latest released version, 1.10.1, dates from February 2025 and does not support newer families such as Flux. This guide covers installation on Windows and Linux, model organization, launch settings based on available VRAM, the most useful extensions such as ADetailer, model file security, and candidly explains when Forge or ComfyUI is a better choice for a new installation.
#What is AUTOMATIC1111?
Stability AI announced the public release of Stable Diffusion on August 22, 2022. A developer known by the pseudonym AUTOMATIC1111 created a repository on GitHub that same day: a browser interface built with the Gradio library and released under the AGPL-3.0 license, eliminating the need to type Python commands. The repository now has more than 160,000 stars. The interface offers tabs for text-to-image, image-to-image, inpainting, and upscaling, plus a huge extension library.
Like all local tools, it runs on your machine and opens in the browser at http://127.0.0.1:7860, never leaving your local network by default. Prompts, settings, and images remain on your disk, available for offline access and reuse.
#What you need
AI images and videos on your own machine, no subscription and no credits: ComfyUI, Flux, Z-Image and Wan 2.2 with ready-to-load workflows, VRAM tiers, LoRA training and the legal frame.
- Lifetime online access
- PDF + files
- Lifetime updates
| Minimum | Comfortable | |
|---|---|---|
| Graphics card | NVIDIA with 4 GB of VRAM (SD 1.5 only, with memory-saving options) | NVIDIA 8 GB for SDXL; 12 GB or more for SDXL with LoRA, ControlNet, and upscaling |
| RAM | 8 GB | 16 GB and up |
| Disk | ≈ 12 GB for the installation and a model | 50 GB or more on an SSD: model collections grow quickly |
| Software | Python 3.10.x and Git | The Python version matters: the README specifies 3.10.6 on Windows and warns that newer versions do not support torch |
AMD cards work natively on Linux with ROCm. On Windows, the official wiki is clear: “Windows+AMD support has not officially been made for webui,” and the practical route goes through lshqqytiger’s community DirectML fork, where training was still not working according to the wiki page, edited in January 2024. On Mac Apple Silicon, the official wiki documents installation via Homebrew and the webui.sh script: most features work, but training is very slow and memory-intensive. NVIDIA remains the best-supported path for the project.
#Installation on Windows and Linux
- 01Install Python 3.10.6From python.org, by checking “Add Python to PATH.” The README states that newer versions do not support torch: stick with 3.10.6, even though the same README allows 3.11 for some very recent Linux distributions.
- 02Install GitGit for Windows on Windows; your distribution's git package on Linux.
- 03Clone the repository and run the scriptIn a folder with a short path, without spaces or accented characters. On Windows, the script is webui-user.bat; on Linux, it is webui.sh.
- 04Wait during the first launchThe script downloads PyTorch and its dependencies, several gigabytes in total: allow ten minutes to half an hour. When a local address appears, open it in your browser.
#Where to store the models
- models/Stable-diffusion
- Checkpoints—in other words, the main model files—in .safetensors format.
- models/Lora
- LoRAs, which add a style or subject to a base model.
- models/VAE
- Optional VAEs; many SDXL checkpoints include their own.
- extensions
- The extensions, managed from the tab with the same name.
- outputs
- Your images, sorted by mode and date.
A fresh installation may not contain a model: older versions automatically downloaded SD 1.5 on first launch, but that is no longer guaranteed. Download an SDXL checkpoint from Hugging Face, place it in models/Stable-diffusion, then click the refresh icon next to the model selector. Use only .safetensors files: the older .ckpt format can execute code when opened, as detailed below.
#Launch options based on your VRAM
The options go on the COMMANDLINE_ARGS line in webui-user.bat on Windows or webui-user.sh on Linux.
| Option | Effect | When to use it |
|---|---|---|
| --xformers | Memory-efficient attention: faster, less VRAM | Almost always, on a NVIDIA card |
| --medvram | Keeps only part of the model on the GPU at a time; slower | 6 to 8 GB cards with SDXL |
| --medvram-sdxl | Same, applied only to SDXL models | 8 GB cards that handle SD 1.5 comfortably |
| --lowvram | Aggressive offloading, much slower | 4 GB cards, as a last resort |
| --no-half-vae | Disables VAE half-precision | Black or green images |
| --api | Enable the REST API | Control the interface from a script or another application |
| --listen | Accepts connections from the local network | Use from a tablet or another PC; add authentication |
#Settings for a first image
| Setting | Starting value | Role |
|---|---|---|
| Sampling method | DPM++ 2M Karras, or Euler a | The denoising algorithm; these two are safe bets |
| Sampling steps | 20 à 30 | More steps, more time, diminishing returns beyond 30 |
| Width × Height | 1024 × 1024 in SDXL, 512 × 512 in SD 1.5 | Stay close to the native resolution; otherwise, the composition degrades |
| CFG Scale | 5 à 7 | Prompt fidelity; too high, and the image becomes saturated |
| Seed | -1 (random) | Lock it to recreate an image while changing only one detail |
| Hires. fix | Disabled initially | Generate small, then enlarge in a second pass: the classic method for adding detail |
Describe rather than give commands, in English, with the subject first: “portrait of an elderly fisherman, window light, 85mm, shallow depth of field” works better than a list of isolated keywords. The negative prompt lists what to avoid, for example “blurry, deformed hands, extra fingers, low quality” to filter out the most common defects. One function to learn early: the PNG Info tab rereads the prompt and all settings from any image produced by the interface, allowing you to reproduce or adjust a successful generation without retyping everything.
#A1111, Forge, or ComfyUI in 2026
| AUTOMATIC1111 | Forge | ComfyUI | |
|---|---|---|---|
| Interface | Tabs and forms | The same tabs | Node graph |
| Getting started | Soft | Soft | Demanding |
| Speed and VRAM efficiency | Reference | Aims for better resource management and faster inference, according to its README | Describes itself in its README as the most optimized inference engine for consumer hardware |
| Recent models (Flux and later) | No | Supported workflows | Almost everything, generally first |
| Video | No | No | Yes |
| Extensions and tutorials | The largest existing corpus | Most A1111 extensions work | Large and different ecosystem |
| Development pace | Latest version 1.10.1 in February 2025 | Original repository discontinued since June 2025; Neo fork active | Very active |
The verdict is simple. Choose A1111 if you’re following a course, tutorial, or extension written for it, or if your current setup does what you need with SD 1.5 and SDXL. For a new installation with this interface style, look at Forge: it’s a fork maintained by lllyasviel, the author of ControlNet and Fooocus, designed for better resource management and supporting Flux, while preserving the same workflow. The Forge repository says it itself: because the original project is “almost static now,” Forge resynchronizes with it “every 90 days, or when important fixes.” But the Forge repository itself has not received a commit on its main branch since June 2025. Development is now carried on by a community fork, Forge Neo by Haoming02, whose README announces support for recent models (Qwen-Image, Wan 2.2, Z-Image) and which was still being updated in late September 2026. For a community project, check its activity before committing to it. Choose ComfyUI for current models, video, or reproducible pipelines.
- ComfyUI: installation and getting started
- Fooocus: the simplest option for getting started
- The AI Image Kit: settings by graphics card
#Useful extensions and model security
#ADetailer: automatically fix faces and hands
In a wide-shot generated image, faces and hands remain Stable Diffusion's weak point. The ADetailer extension, whose official repository describes it as an extension that “does automatic masking and inpainting,” automatically detects these areas with a recognition model and then runs targeted inpainting on them with its own prompt. It installs directly from the Extensions tab by pasting its GitHub address into “Install from URL.”
Inpainting, specifically, is one of the interface's four basic modes, along with text-to-image, image-to-image, and upscaling: it regenerates only a masked area of the image while keeping the rest identical. ADetailer automates this step instead of making you paint the mask by hand on every face.
#.ckpt and .safetensors files: what the format changes
A .ckpt file is a Python serialization in pickle format, which can execute arbitrary code when opened. Malicious checkpoints have already circulated on community platforms. The .safetensors format solves the problem at its root: according to the format’s official repository, it “implements a new simple format for storing tensors safely (as opposed to pickle) and that is still fast (zero-copy)”. AUTOMATIC1111 includes a check that blocks loading a pickle deemed suspicious before deserializing it, but the simplest rule remains to download only .safetensors files, especially from sources other than Hugging Face or Civitai.
- ControlNet: mastering image composition
- Source: ADetailer’s official repository
- Source: the .safetensors format explained by Hugging Face
#Common errors
- CUDA out of memory
- The image size or model exceeds the VRAM. Add --medvram or --medvram-sdxl, lower the resolution, and close other applications that use the GPU.
- Torch is not able to use GPU
- Driver too old, or GPU that is not a NVIDIA. Update the driver; the CUDA Toolkit is not required.
- Installation fails on dependencies
- Wrong Python version. Install 3.10.x, then delete the venv directory before trying again.
- A recent RTX 50 is not being used
- The stable version bundles a PyTorch release from before the Blackwell architecture. A project contributor documents the workaround in a GitHub discussion updated May 1, 2025: switch to the dev branch (git switch dev), which uses PyTorch 2.7.0 with RTX 50 support, then run it once with --reinstall-torch in COMMANDLINE_ARGS and remove the option afterward. Otherwise, ComfyUI.
#FAQ
Is AUTOMATIC1111 free?+
Is AUTOMATIC1111 still being updated?+
Which Python version is required for AUTOMATIC1111?+
How much VRAM does AUTOMATIC1111 need?+
Does AUTOMATIC1111 work without an Internet connection?+
What is ADetailer used for in AUTOMATIC1111?+
Should you avoid .ckpt files downloaded online?+
Feedback, an error, or a clarification? Let us know—it improves the guide for everyone.