stable-diffusion-webui README

The project's README from github.com/AUTOMATIC1111/stable-diffusion-webui. As one markdown file: README.md.

Stable Diffusion web UI

A web interface for Stable Diffusion, implemented using Gradio library.

Features

Detailed feature showcase with images:

Installation and Running

Make sure the required dependencies are met and follow the instructions available for:

Alternatively, use online services (like Google Colab):

Installation on Windows 10/11 with NVidia-GPUs using release package

  1. Download sd.webui.zip from v1.0.0-pre and extract its contents.
  2. Run update.bat.
  3. Run run.bat.

    For more details see Install-and-Run-on-NVidia-GPUs

Automatic Installation on Windows

  1. Install Python 3.10.6 (Newer version of Python does not support torch), checking "Add Python to PATH".
  2. Install git.
  3. Download the stable-diffusion-webui repository, for example by running git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git.
  4. Run webui-user.bat from Windows Explorer as normal, non-administrator, user.

Automatic Installation on Linux

  1. Install the dependencies:
# Debian-based:
sudo apt install wget git python3 python3-venv libgl1 libglib2.0-0
# Red Hat-based:
sudo dnf install wget git python3 gperftools-libs libglvnd-glx
# openSUSE-based:
sudo zypper install wget git python3 libtcmalloc4 libglvnd
# Arch-based:
sudo pacman -S wget git python3

If your system is very new, you need to install python3.11 or python3.10:

# Ubuntu 24.04
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11

# Manjaro/Arch
sudo pacman -S yay
yay -S python311 # do not confuse with python3.11 package

# Only for 3.11
# Then set up env variable in launch script
export python_cmd="python3.11"
# or in webui-user.sh
python_cmd="python3.11"
  1. Navigate to the directory you would like the webui to be installed and execute the following command:
wget -q https://raw.githubusercontent.com/AUTOMATIC1111/stable-diffusion-webui/master/webui.sh

Or just clone the repo wherever you want:

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
  1. Run webui.sh.
  2. Check webui-user.sh for options.

Installation on Apple Silicon

Find the instructions here.

Contributing

Here's how to add code to this repo: Contributing

Documentation

The documentation was moved from this README over to the project's wiki.

For the purposes of getting Google and other search engines to crawl the wiki, here's a link to the (not for humans) crawlable wiki.

Credits

Licenses for borrowed code can be found in Settings -> Licenses screen, and also in html/licenses.html file.

stable-diffusion-webui (AUTOMATIC1111/stable-diffusion-webui)

Searching Database…

Что это такое?Веб-интерфейс для Stable Diffusion, построенный на библиотеке Gradio, который позволяет генерировать и редактировать изображения с помощью ИИ (txt2img, img2img, inpainting, outpainting и другие режимы) на вашем собственном компьютере.
Это настольное приложение или то, что открывается в браузере?Это локальный веб-сервер: вы запускаете его скриптом, а затем пользуетесь им через браузер, как обычной веб-страницей, а не как традиционным установленным настольным приложением.
Как это запустить?В Windows скачайте пакет релиза sd.webui.zip, распакуйте его, затем запустите update.bat, а после — run.bat; либо выполните автоматическую установку, клонировав репозиторий и запустив webui-user.bat. В Linux установите перечисленные зависимости и запустите webui.sh.
Нужно ли сначала установить Python и git?Да: для автоматического установщика нужен именно Python 3.10.6 (новые версии ломают torch) с включённым PATH, а также git; готовый пакет для Windows тоже требует оба, чтобы запускать скрипты.
Работает ли это на видеокартах с малым объёмом VRAM или не от NVIDIA?Поддерживаются GPU с объёмом VRAM от 4 ГБ (некоторые сообщают, что работает и с 2 ГБ), но рекомендуемый путь — NVIDIA; для AMD, процессоров и видеокарт Intel, а также NPU Ascend нужны отдельные инструкции по установке.
Нужна ли видеокарта NVIDIA или можно использовать AMD или Intel?Рекомендуется NVIDIA, но в проекте описаны отдельные варианты установки для видеокарт AMD и для процессоров и видеокарт Intel (как встроенных, так и дискретных), а также для NPU Ascend и компьютеров Mac на Apple Silicon.
Чем отличается готовый пакет Windows в один клик от автоматической установки?Готовый пакет (sd.webui.zip) уже включает почти всё необходимое: достаточно запустить update.bat, а затем run.bat. При автоматической установке нужно самостоятельно поставить Python 3.10.6 и git, клонировать репозиторий и запустить webui-user.bat.
Что можно делать с LoRA и гиперсетями?Оба варианта позволяют подстраивать стиль генерируемых изображений с помощью небольших дополнительных файлов; в интерфейсе есть отдельный выбор с превью, так что можно добавлять LoRA, гиперсети или textual-inversion embeddings прямо в запрос.
Можно ли управлять им из скриптов, а не через интерфейс в браузере?Да, он предоставляет API, поэтому генерацию можно запускать программно, а не только через интерфейс Gradio.
Что делает вкладка Extras?Она объединяет инструменты восстановления лиц и увеличения разрешения (GFPGAN, CodeFormer, RealESRGAN, ESRGAN, SwinIR, LDSR), которые можно применять к уже готовым изображениям, чтобы исправить лица или увеличить разрешение.
Size
35.7 MB
Stars
165.1K
Age
4y
Commits · 90 Days