AiBOX.im

Stable Diffusion WebUI

The classic AI image web UI (A1111, biggest ecosystem)

— views · — installs
WindowsmacOS Difficulty ●●●●● stable v1.10.1
Stable Diffusion WebUI icon

Stable Diffusion WebUI · icon from the registry

System requirements

No extra runtime needed

This app ships with everything it needs — no Node.js, Python or other runtimes to install.

Platforms

WindowsmacOS

The classic AI image web UI (A1111, biggest ecosystem)

Registry data updated: 2026-11-16

Config & data

Config file written to

~/SillyTavern/data/default-user/settings.json

  • ~/sd-webui
  • ~/sd-webui

Everything stays on your own machine — nothing is uploaded. To uninstall, delete these folders.

Install in three steps

  1. 01

    Install AiBOX

    One portable file for Windows (macOS coming). Double-click and it runs — no installer, no administrator rights.

    Go to download →
  2. 02

    Pick Stable Diffusion WebUI

    Open the AiBOX app catalog, find Stable Diffusion WebUI and press Install. AiBOX checks what your machine already has and installs only what is missing.

  3. 03

    Follow the wizard

    It downloads with a checksum check, writes the config and fills in your API key if the app needs one. You just click.

    ✓ Installed until it works.

Prefer to do it by hand? The full written guide is right below. Read the guide ↓

Install guide

The same steps in written form — follow along at your own pace.

One line: A1111 is the classic Stable Diffusion web interface — txt2img, img2img, inpainting, upscaling, embedding training, plus the thickest plugin and model ecosystem around; most community tutorials and models target it first.

What you get

  • A full AI image workbench in your browser: text-to-image, image-to-image, inpainting, X/Y/Z parameter grids, hires upscaling
  • A huge community: plugins (ControlNet, prompt helpers…) and models — drop any Civitai SD1.5 / SDXL checkpoint in and it appears in the dropdown
  • An --api flag that exposes the whole thing as a local HTTP API for scripting

Before you start (read the Python note)

NeedNotes
Python 3.10.6 (recommended)Official instruction: install 3.10.6 and tick "Add Python to PATH" — newer Python versions don't work with torch (3.11+ requires setting python_cmd manually; not beginner-friendly)
GitFree from git-scm.com
GPUNVIDIA discrete GPU preferred (4GB VRAM floor); iGPU/CPU works but is slow
Disk~1GB for the program, plus ~2.5GB of PyTorch on first launch and a model (SDXL checkpoints are 6–7GB)
PermissionsZero admin — installs into your user folder

Install

Route A: install with AiBOX (recommended)

  1. Open AiBOX → app directory → Stable Diffusion WebUI → Install
  2. It downloads the official tag archive (hash-verified, CN traffic switches gateway automatically) and clones it to ~/sd-webui
  3. A user-level venv is created and dependencies installed — your system Python stays untouched, no admin rights
  4. The first launch pulls PyTorch and friends (set PIP_INDEX_URL to a domestic mirror if it's slow)

Route B: manual install (official commands)

git clone --depth 1 -b v1.10.1 https://github.com/AUTOMATIC1111/stable-diffusion-webui.git ~/sd-webui
cd ~/sd-webui
python -m venv venv                                  # isolated environment
./venv/bin/pip install -r requirements.txt           # Windows: .\venv\Scripts\pip
./venv/bin/python launch.py                          # first run finishes the setup

On Windows you can also use the official script: with Python 3.10.6 and Git installed, double-click webui-user.bat in the cloned folder as a normal user (never "Run as administrator"). Linux needs system packages first: sudo apt install wget git python3 python3-venv libgl1 libglib2.0-0.

Configuration & verification

Launch flags (the four that matter)

Put flags in COMMANDLINE_ARGS= inside webui-user.bat (Windows) or webui-user.sh (Linux):

FlagWhat it does
--medvram / --lowvramAdd this on CUDA out-of-memory errors — trades speed for VRAM
--xformersMemory-efficient attention, faster on NVIDIA
--apiEnables the local API (/sdapi/v1/*, Swagger UI at /docs)
--listen --port 7860LAN access (keep the firewall restricted to your network)
--precision full --no-halfCommon fix for completely black images

Example: set COMMANDLINE_ARGS=--medvram --xformers in webui-user.bat.

Downloading and placing models

  1. Grab a .safetensors checkpoint from Civitai or Hugging Face
  2. Drop it into ~/sd-webui/models/Stable-diffusion/, refresh, and it shows up in the top dropdown
  3. Same idea for the rest: models/VAE, models/Lora, embeddings/, models/ControlNet
  4. With no model present, the first launch auto-downloads the official SD 1.5 / SDXL weights (or pre-place them to skip the wait)

Installing plugins (one line)

Sidebar Extensions → Install from URL, paste the plugin repo (or search under the Available tab via Load from index), install, then Apply and restart UI.

What "success" looks like

  1. The terminal prints Running on local URL: http://127.0.0.1:7860 — open it
  2. Pick a model at the top, type any prompt, hit Generate
  3. The progress bar completes and an image appears (the PNG Info tab shows its generation parameters)

FAQ

  • Slow dependency / PyTorch downloads: set PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple and reinstall (the AiBOX route mirrors automatically)
  • torch / CUDA version errors: confirm Python is 3.10.6; if you installed the wrong version, delete venv and recreate it
  • CUDA out of memory: add --medvram (then --lowvram if needed) or generate at smaller resolutions
  • All-black images: add --precision full --no-half
  • MetadataIncompleteBuffer / PytorchStreamReader on a model: the file is corrupt — download it again
  • Port in use: add --port 7861 to COMMANDLINE_ARGS

Uninstall

rm -rf ~/sd-webui     # venv, models and outputs all live here — back up models/ and outputs/ first

AiBOX's Manage → Uninstall handles it.

More: GitHub README · install & run wiki · features wiki

Model / API key setup

AiBOX fills this in for you during the wizard — this section is for setting it up by hand.

OpenRouter

You need an API key from the provider.

~/SillyTavern/data/default-user/settings.json

Get a key ↗

Anthropic (Claude)

You need an API key from the provider.

~/SillyTavern/data/default-user/settings.json

Get a key ↗

OpenAI

You need an API key from the provider.

~/SillyTavern/data/default-user/settings.json

Get a key ↗

Google AI Studio

You need an API key from the provider.

~/SillyTavern/data/default-user/settings.json

Get a key ↗

Claude subscription

Sign in with your account instead — no key to copy.

~/SillyTavern/data/default-user/settings.json

Get a key ↗

Ollama (local)

Local model — no API key needed.

~/SillyTavern/data/default-user/settings.json

Common questions

Which platforms does Stable Diffusion WebUI run on?

Runs on Windows / macOS — install it with AiBOX on any of them.

How hard is Stable Diffusion WebUI to install?

Difficulty 5 out of 5. AiBOX does the download and setup; your part is clicking through the wizard and pasting a key if the app needs one.

Where does Stable Diffusion WebUI keep my data?

Everything stays on your own machine: ~/sd-webui / ~/sd-webui. To uninstall, delete these — nothing is ever uploaded.

Something not working?

An outdated step, an error you do not understand, a typo — tell us and we will fix this page.

Report a problem →

Version & updates

Current version
v1.10.1
Registry data updated
2026-11-16

Version numbers are re-checked by our daily probe — when upstream ships a new release, this page follows.

Questions or problems?

A wrong step, a confusing error, a typo — open an issue and someone will look.