How to install automatic1111 Stable Diffusion webui?
To install AUTOMATIC1111 WebUI, first install Python 3.10.6 and Git, then clone the repo from github.com/AUTOMATIC1111/stable-diffusion-webui, drop a model checkpoint into the models/Stable-diffusion folder, and run webui-user.bat on Windows or webui.sh on Linux and Mac. It auto-downloads all dependencies and opens a browser interface at 127.0.0.1:7860.
Why — the first-principles explanation
AUTOMATIC1111's WebUI is a local web app that wraps Stable Diffusion in a browser interface. Understanding its three ingredients makes installation clear: a Python environment to run the code, the repository containing the app, and a model checkpoint that actually generates images.
The reason you need a specific Python version, 3.10.6, is that the machine-learning libraries it depends on are pinned to versions tested against that release. Newer Python can break dependency installation, which is the most common cause of failed installs. Git is used to download and later update the code.
When you first run the launcher script, it builds an isolated environment and downloads gigabytes of dependencies, including PyTorch, the framework that talks to your GPU. This first run is slow; later launches are fast because everything is cached. The app then serves a page on your own machine at a local address, so nothing goes online.
The model checkpoint is separate on purpose. The WebUI is just the interface; you choose which model to load by placing .safetensors files in the models folder. This modular design lets you swap between photorealistic, anime, or fine-tuned models without reinstalling anything. On Windows an NVIDIA GPU is expected; AMD and Apple Silicon need slightly different setup flags.
An example that makes it click
Think of it like setting up a home game console. Python and Git are the power cables and the console itself. Cloning the repo is unboxing the console. The model checkpoint is the game disc, without a disc, the console turns on but has nothing to play.
The first time you plug everything in, it downloads a big system update, so it takes a while. After that, you just press the power button, webui-user.bat, and it boots straight to the menu in your browser.
How to do it
- Install Python 3.10.6 from python.org, checking 'Add Python to PATH' during setup.
- Install Git from git-scm.com.
- Open a terminal and run: git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
- Download a model checkpoint (.safetensors) and place it in the models/Stable-diffusion folder.
- On Windows, double-click webui-user.bat; on Linux or Mac, run ./webui.sh in the folder.
- Wait for the first-run dependency download to finish, then open the shown local URL (usually http://127.0.0.1:7860).
- To update later, run 'git pull' inside the folder.
Key facts
- AUTOMATIC1111 WebUI requires Python 3.10.6 specifically for dependency compatibility.
- The official repository is github.com/AUTOMATIC1111/stable-diffusion-webui.
- Model checkpoints go in the models/Stable-diffusion folder and are loaded from a dropdown.
- The WebUI runs locally and opens by default at http://127.0.0.1:7860.
- First launch downloads several gigabytes of dependencies including PyTorch; later launches are fast.
The open-source image model you can run on your own hardware.
Affiliate link — we may earn a commission at no cost to you.▶ The 60-second explainer (script)
Let's install AUTOMATIC1111, the most popular Stable Diffusion interface. You'll need three things: Python, Git, and a model file. Step one: install Python version 3.10.6 specifically, and check the box that says 'Add Python to PATH'. That exact version matters, because the libraries are tuned for it. Step two: install Git. Step three: open a terminal and clone the project with git clone, then the AUTOMATIC1111 stable-diffusion-webui GitHub link. Step four: download a model checkpoint, a .safetensors file, and drop it into the folder called models, then Stable-diffusion. Without a model, the app opens but can't make anything. Step five: on Windows, double-click webui-user.bat. On Mac or Linux, run webui.sh. The first launch downloads a few gigabytes of dependencies, so be patient. When it's done, it prints a local web address, usually 127.0.0.1 colon 7860. Open that in your browser and you're generating images. To update later, just run git pull in the folder.
What authoritative sources say
People also ask
Why must I use Python 3.10.6?
The WebUI's machine-learning dependencies are tested against that version. Newer Python often causes install errors, so 3.10.6 is the safe choice.
Where do I get a model checkpoint?
Download .safetensors models from Hugging Face or Civitai, then place them in the models/Stable-diffusion folder.
Does it work on AMD or Mac?
Yes, with extra steps. AMD needs ROCm on Linux or DirectML on Windows, and Apple Silicon uses the webui.sh script with MPS support.
How do I update AUTOMATIC1111?
Open a terminal in the install folder and run 'git pull' to fetch the latest version, then relaunch.