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