INSTALLATION - LINUX

The Big Rule: Python 3.10

You need Python 3.10. Newer versions (3.11, 3.12) break dependencies.

Ubuntu 20.04 or 22.04 (Easy Mode)

Python 3.10 is already there. Just do this:

sudo apt install wget git python3 python3-venv libgl1 libglib2.0-0

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
cd stable-diffusion-webui
./webui.sh

Done.

Ubuntu 24.04 (Needs Extra Work)

24.04 ships with Python 3.12, which doesn't play nice. Grab 3.10 from the deadsnakes PPA:

sudo apt install git software-properties-common -y
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt install python3.10 python3.10-venv libgl1 libglib2.0-0 -y

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
cd stable-diffusion-webui

# Force it to use 3.10
python3.10 -m venv venv

./webui.sh

Or just set it in webui-user.sh so you don't have to think about it:

#!/bin/bash
python_cmd="python3.10"
export COMMANDLINE_ARGS="--xformers --autolaunch"

GPU Stuff

NVIDIA:

Get the proprietary drivers installed. Check with nvidia-smi.
PyTorch brings its own CUDA runtime so you don't need the toolkit.
Add --xformers for better performance.

AMD (ROCm):

Install ROCm drivers first.
Add these flags: --precision full --no-half
RX 7000 series also needs: export HSA_OVERRIDE_GFX_VERSION=11.0.0

No GPU? CPU fallback:

export COMMANDLINE_ARGS="--use-cpu all --precision full --no-half --skip-torch-cuda-test"
(It'll be slow, but it works)

When Things Go Wrong

"Could not find a version that satisfies the requirement torch":

Wrong Python version. Make sure you're actually using 3.10.

"CUDA out of memory":

Add --medvram or --lowvram, turn on --xformers, drop the resolution

Black or green images:

Add --no-half-vae or go full precision with --precision full --no-half

OpenGL library errors:

sudo apt install libgl1 libglib2.0-0