COMRAD404 COMRAD404 ИИ-сигналы, агенты и практическая разведка
COMRAD404 / HOWTO

Как установить и запустить Stable Diffusion WebUI

Портрет автора Редакция Comrad404
Автор Редакция Comrad404 Автор COMRAD404

Официальный запуск AUTOMATIC1111 Stable Diffusion WebUI на Windows, Linux и Apple Silicon: что поставить, что запускать, как проверить первый старт и какие ошибки не пропустить.

Понадобится

30–90 минут
  • Один из сценариев: Windows, Linux или macOS на Apple Silicon
  • Git
  • Python 3.10.6 для Windows или python3.10/3.11 по README для новых Linux
  • Homebrew и пакеты cmake, protobuf, rust, [email protected], git, wget для Apple Silicon
  • Совместимый checkpoint модели для генерации
  • NVIDIA GPU, если вы идёте по Windows/NVIDIA release-package пути
  • Интернет для первого клонирования и обновления

После этой установки вы запустите AUTOMATIC1111 Stable Diffusion WebUI в браузере и проверите первый старт по адресу http://127.0.0.1:7860. Для Windows с NVIDIA самый короткий официальный путь — release-package flow; для Linux и Apple Silicon используйте отдельные инструкции из README и wiki.

Практический вердикт: не пытайтесь собрать «универсальную» установку по памяти. В текущих официальных материалах документация вынесена из README в wiki, а шаги зависят от ОС и GPU. Этот гайд держит только проверяемые пути из источников.

Сводка

  • ⏱️ Время: 30–90 минут, в зависимости от ОС, скачивания зависимостей и модели.
  • 🎯 Сложность: средний.
  • 💰 Стоимость: бесплатно; возможны расходы на GPU, облако или модельные хостинги у сторонних провайдеров.
  • 🛠️ Что потребуется: Windows, Linux или macOS на Apple Silicon; Git; Python 3.10.6 для Windows или python3.10/3.11 для новых Linux; Homebrew и пакеты для Apple Silicon; совместимый checkpoint модели; NVIDIA GPU, если вы идёте по Windows/NVIDIA пути.
  • 📌 Актуальная версия: 1.10.1 (опубликована 2025-02-09); источники проверены на 2026-08-14.

Оглавление

Как выбрать путь установки

Выберите только один официальный сценарий. Для Windows есть два варианта: чистая установка через webui-user.bat и ускоренный NVIDIA-путь через release package. Для Linux и Apple Silicon используйте отдельные инструкции, а не Windows-скрипты.

Сценарий Что запускать Когда выбирать Что важно
Windows automatic install webui-user.bat Чистая установка на Windows Python 3.10.6, Git, запуск от обычного пользователя
Windows NVIDIA release package update.bat → run.bat Быстрый старт на Windows с NVIDIA Архив sd.webui.zip из v1.0.0-pre; для 50-series вики указывает dev branch path
Linux automatic install webui.sh Debian, Red Hat, openSUSE, Arch-based Linux Системные зависимости из README; на новых дистрибутивах может понадобиться python3.11 или python3.10 и python_cmd
Apple Silicon ./webui.sh macOS на Apple Silicon Homebrew-пакеты, модель в stable-diffusion-webui/models/Stable-diffusion, возможны --medvram или --lowvram

Лимит источников для Linux заметен: в этом пакете не перечислен полный список пакетов дистрибутива. Если вы ставите Linux-версию, перепроверьте README своей ветки перед запуском.

Windows: автоматическая установка

Этот путь указан в README как обычная установка под Windows: ставите Python 3.10.6, ставите Git, клонируете репозиторий и запускаете webui-user.bat без прав администратора.

  1. Установите Python 3.10.6. Это версия, которую README называет для Windows; ожидаемый результат — python --version показывает 3.10.6.
  2. Установите Git. Без него вы не клонируете репозиторий; ожидаемый результат — команда git --version работает.
  3. Склонируйте репозиторий. Используйте официальный URL проекта: https://github.com/AUTOMATIC1111/stable-diffusion-webui.
  4. Запустите webui-user.bat от обычного пользователя. README отдельно просит не запускать установку из-под администратора.
  5. Дождитесь первого старта и откройте локальный адрес. Ожидаемый результат — в консоли появляется строка Running on local URL: http://127.0.0.1:7860.

Windows: NVIDIA release package

В wiki для NVIDIA описан более короткий путь: скачайте sd.webui.zip из v1.0.0-pre, распакуйте архив, запустите update.bat, затем run.bat.

  1. Скачайте sd.webui.zip из v1.0.0-pre. Это стартовый пакет, который вики указывает для Windows с NVIDIA.
  2. Распакуйте архив. После распаковки у вас должен остаться каталог с батниками и файлами WebUI.
  3. Запустите update.bat. Это подготавливает пакет перед первым запуском.
  4. Запустите run.bat. Ожидаемый результат — консоль начинает старт и затем выводит локальный URL.
  5. Откройте http://127.0.0.1:7860. После первого запуска вики ожидает строку Running on local URL: http://127.0.0.1:7860.

Если у вас RTX 50-series, в wiki на момент правки указан отдельный путь: PyTorch 2.7 ещё не был слит в master, поэтому нужно переключаться на dev branch по инструкции из той же wiki-страницы.

Linux: автоматическая установка

README описывает Linux-установку как последовательность: поставить системные зависимости, затем либо скачать webui.sh через wget, либо клонировать репозиторий, и после этого запустить webui.sh. Для очень новых систем README советует python3.11 или python3.10 и отдельную настройку python_cmd.

  1. Установите зависимости своего дистрибутива. Точный список в этом пакете не приведён, поэтому сверяйтесь с README для вашей ветки Linux.
  2. Получите webui.sh или клонируйте репозиторий. Оба варианта названы в README как допустимые.
  3. Если дистрибутив очень новый, задайте python_cmd. README прямо рекомендует python3.11 или python3.10 в таком случае.
  4. Запустите webui.sh. Ожидаемый результат — WebUI стартует и выводит локальный адрес в консоль.

Apple Silicon: установка на macOS

Apple Silicon-путь в wiki начинается с Homebrew, затем ставятся зависимости, клонируется репозиторий, модели кладутся в нужную папку, после чего запускается ./webui.sh.

brew install cmake protobuf rust [email protected] git wget
  1. Установите Homebrew. Это первый шаг Apple Silicon-инструкции.
  2. Поставьте зависимости через Homebrew. Команда выше соответствует wiki-списку.
  3. Склонируйте репозиторий. Используйте официальный репозиторий AUTOMATIC1111/stable-diffusion-webui.
  4. Положите модели в stable-diffusion-webui/models/Stable-diffusion. Это путь, который wiki указывает для моделей на Apple Silicon.
  5. Запустите ./webui.sh. Для повторного запуска просто снова выполните тот же скрипт; при необходимости сначала сделайте git pull.

Wiki отдельно предупреждает: обучение на Apple Silicon очень медленное и памятьёмкое, а для слабых режимов GPU-ускорения может понадобиться --medvram или --lowvram. CLIP interrogator и training отмечены как отдельные исключения.

Как запустить в локальной сети или через ссылку

По wiki аргументы запуска работают так: --listen включает прослушивание сетевых подключений для LAN, --port выбирает порт, а --share создаёт публичную Gradio-ссылку. Используйте их только если вам действительно нужен внешний доступ.

  1. Добавьте --listen. Это включает доступ для локальной сети.
  2. Добавьте --port, если нужен другой порт. Это не обязательный шаг, а выбор порта.
  3. Добавьте --share, если нужна публичная ссылка. После этого WebUI получит публичный Gradio URL.

Как проверить, что всё работает

  1. Проверьте строку в консоли. Успешный старт подтверждает Running on local URL: http://127.0.0.1:7860.
  2. Откройте адрес в браузере. Если страница загружается на той же машине, базовый запуск удался.
  3. Сделайте короткую тестовую генерацию после добавления checkpoint. Для генерации нужен совместимый checkpoint; результатом должен быть сгенерированный кадр.

Частые ошибки и исправления

  • ❌ Ошибка: на Windows установлена не та версия Python. ✅ Решение: поставьте Python 3.10.6 и снова запустите webui-user.bat.
  • ❌ Ошибка: Windows-установка запускалась от администратора. ✅ Решение: откройте обычную учётную запись и повторите запуск без повышения прав.
  • ❌ Ошибка: на очень новом Linux-дистрибутиве ломается запуск. ✅ Решение: используйте python3.11 или python3.10 и укажите python_cmd.
  • ❌ Ошибка: WebUI не открывается по сети. ✅ Решение: добавьте --listen; если нужен другой порт, добавьте --port.
  • ❌ Ошибка: RTX 50-series или Apple Silicon работают не так, как ожидалось. ✅ Решение: для 50-series следуйте dev-branch note из NVIDIA wiki; на Apple Silicon используйте --medvram или --lowvram, если упираетесь в память.

Безопасность и ограничения

  • По умолчанию вы стартуете локально, а базовая проверка идёт через 127.0.0.1:7860.
  • --listen открывает WebUI для сети LAN.
  • --share создаёт публичную Gradio-ссылку.
  • Для генерации нужен совместимый checkpoint; точный выбор модели и её лицензия зависят от внешнего источника.
  • На Apple Silicon обучение очень медленное и памятьёмкое; wiki отдельно отмечает CLIP interrogator и training как исключения.

Если вам не нужен внешний доступ, не включайте --share и не публикуйте UI наружу без необходимости.

Что делать дальше

Вопросы и ответы

Можно ли установить без NVIDIA?

Да. В источниках есть отдельные пути для Windows, Linux и Apple Silicon. Release-package flow описан именно для Windows с NVIDIA, а не для всех платформ сразу.

Как понять, что первый запуск успешен?

Ищите в консоли строку Running on local URL: http://127.0.0.1:7860, затем откройте этот адрес в браузере.

Можно ли открыть WebUI из локальной сети?

Да. Для этого в wiki указан аргумент --listen; --port меняет порт, а --share создаёт публичную Gradio-ссылку.

Что делать на RTX 50-series?

В NVIDIA wiki на момент её правки сказано, что для 50-series нужен dev branch path, потому что PyTorch 2.7 ещё не был слит в master.

Нужен ли checkpoint модели?

Да, для генерации изображений нужен совместимый checkpoint. На Apple Silicon wiki прямо указывает каталог stable-diffusion-webui/models/Stable-diffusion.

Источники

Шаги

HOW-TO
  1. Выберите путь установки

    | Сверьте свою ОС и GPU с таблицей в статье и выберите один официальный сценарий. Результат: вы знаете, какой скрипт запускать и какие зависимости ставить.

  2. Поставьте зависимости своей платформы

    | Windows: Python 3.10.6 и Git; Linux: зависимости дистрибутива и при необходимости python3.11/python3.10 с python_cmd; Apple Silicon: Homebrew-пакеты.

  3. Получите файлы WebUI

    | Клонируйте репозиторий через https://github.com/AUTOMATIC1111/stable-diffusion-webui или скачайте release package на Windows/NVIDIA.

  4. Запустите официальный скрипт

    | Используйте webui-user.bat, update.bat + run.bat, webui.sh или ./webui.sh в зависимости от пути. Результат: начинается первый старт.

  5. Откройте локальный адрес

    | Дождитесь строки Running on local URL: http://127.0.0.1:7860 и откройте адрес в браузере. Результат: WebUI загружается локально.

  6. Включите LAN или public access только при необходимости

    | Добавьте --listen, --port или --share через COMMANDLINE_ARGS или launch args. Результат: WebUI слушает сеть или получает Gradio link.

Источники

SOURCES

Вопросы и ответы

FAQ
Можно ли установить без NVIDIA?

Да. В источниках есть отдельные пути для Windows, Linux и Apple Silicon. Release-package flow описан именно для Windows с NVIDIA, а не для всех платформ сразу.

Как понять, что первый запуск успешен?

Ищите в консоли строку Running on local URL: http://127.0.0.1:7860, затем откройте этот адрес в браузере.

Можно ли открыть WebUI из локальной сети?

Да. Для этого в wiki указан аргумент --listen; --port меняет порт, а --share создаёт публичную Gradio-ссылку.

Что делать на RTX 50-series?

В NVIDIA wiki на момент её правки сказано, что для 50-series нужен dev branch path, потому что PyTorch 2.7 ещё не был слит в master.

Нужен ли checkpoint модели?

Да, для генерации изображений нужен совместимый checkpoint. На Apple Silicon wiki прямо указывает каталог stable-diffusion-webui/models/Stable-diffusion.

Читайте также

LINKS
howtoКак настроить RAG с LlamaIndexhowtoКак создать простого AI-агента с LangChainhowtoКак использовать DALL·E 3 в ChatGPThowtoКак создать изображение в Midjourney: от промпта до результатаhowtoКак использовать Windsurf (Codeium) для разработки