INSTALLATION - MACOS APPLE SILICON

The Big Rule: Python 3.10

You need Python 3.10. Not 3.11. Not 3.12. Those break dependencies. 3.10 or bust.

Get Your Prerequisites

1. Xcode Command Line Tools:

xcode-select --install

2. Homebrew (if you don't have it):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Watch for PATH instructions after it finishes.

3. The packages you need:

brew install cmake protobuf rust python@3.10 git wget

What You Need Hardware-Wise

• 8GB RAM minimum (16GB+ way better)
• About 6-7GB disk space, plus your models

Install Steps

1. Grab the repo:

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

2. Drop a model in there:

Put any .safetensors file in models/Stable-diffusion/
(grab v1-5-pruned-emaonly.safetensors from HuggingFace to start)

3. Fire it up (first run takes 10-30 min):

./webui.sh

Recommended Config

Make a webui-user.sh file in the stable-diffusion-webui folder:

export COMMANDLINE_ARGS="--skip-torch-cuda-test --upcast-sampling --no-half-vae --use-cpu interrogate"

What those do:

--skip-torch-cuda-test   Skips a CUDA check that doesn't apply to you
--upcast-sampling        Better precision on MPS
--no-half-vae            Stops black/corrupted images
--use-cpu interrogate    CLIP interrogator doesn't do MPS

Running Tight on RAM? (8GB Macs)

export PYTORCH_MPS_HIGH_WATERMARK_RATIO=0.0
./webui.sh --opt-split-attention-v1 --medvram

When Things Go Wrong

"LayerNormKernelImpl" or "upsample_nearest2d_channels_last" errors:

Add --no-half (slower but it'll work)

"MPS backend out of memory":

Drop to 512x512, batch size 1, add --medvram, close other apps

"xcrun: error: invalid active developer path":

Run xcode-select --install again

WebUI won't start after an update:

Nuke it and start fresh:
rm -rf venv repositories && ./webui.sh