Installation - Macos Apple Silicon

Deep dive

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

1. 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.

1. 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

1. Drop a model in there:

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

1. 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