Установка Stable Diffusion WebUI чаще всего «ломается» на одном из трёх этапов: не установлен Python нужной версии, отсутствует Git или видеокарта не проходит проверку при первом запуске webui-user.bat. Если скрипт завершается ошибкой сразу после запуска или зависает на скачивании репозиториев — в большинстве случаев причина именно в подготовке окружения, а не в самом интерфейсе.
Ниже разобрана полная процедура: от проверки железа до первой сгенерированной картинки. Инструкция ориентирована на Windows 10/11 и самый популярный интерфейс — AUTOMATIC1111 Stable Diffusion WebUI, который распространяется бесплатно через GitHub. Шаги для Linux отличаются и в этой статье подробно не рассматриваются.
Требования к системе перед установкой
Прежде чем скачивать что-либо, убедитесь, что компьютер подходит для локальной генерации изображений. Главный компонент — видеокарта: именно она выполняет все вычисления. Лучше всего поддерживаются карты NVIDIA с технологией CUDA; как правило, нужно не менее 4 ГБ видеопамяти, а для комфортной работы — 6–8 ГБ и больше. Точные минимальные требования зависят от версии WebUI и используемых моделей, поэтому сверяйтесь с актуальным описанием в репозитории проекта.
Что касается остального железа и ПО, ориентиры такие:
- 🎮 GPU: предпочтительно NVIDIA с поддержкой CUDA; карты AMD и работа на CPU возможны, но требуют отдельных настроек и работают медленнее.
- 💾 Место на диске: запас от 15–20 ГБ — сам интерфейс, зависимости Python и хотя бы одна модель (обычно 2–7 ГБ каждая).
- 🧠 ОЗУ: желательно 16 ГБ и более, особенно если планируется обучение или обработка больших изображений.
- 🪟 ОС: 64-разрядная Windows 10 или 11 с актуальными драйверами видеокарты.
- 🌐 Интернет: стабильное соединение на время установки — скачивается несколько гигабайтов зависимостей.
⚠️ Внимание: обновите драйверы видеокарты до актуальной версии до начала установки. Устаревший драйвер — частая причина ошибок CUDA при первом запуске, и диагностировать это по тексту ошибки бывает непросто.
Шаг 1. Установка Python и Git
WebUI работает на Python, и версия имеет значение: проект ориентирован на Python 3.10.x. Более новые ветки (3.11, 3.12) могут вызывать несовместимость с зависимостями, поэтому ставьте именно 3.10 — это указано в документации репозитория. Скачивайте установщик только с официального сайта python.org.
При установке Python есть один критичный момент: в первом окне установщика отметьте галочку Add Python to PATH. Без неё командная строка не найдёт интерпретатор, и скрипт установки завершится ошибкой «Python is not recognized». Проверить результат можно командой python --version в командной строке — она должна вывести номер установленной версии.
Второй обязательный компонент — Git. Он нужен для клонирования репозитория WebUI и последующих обновлений интерфейса. Скачайте установщик с официального сайта git-scm.com и установите с настройками по умолчанию. Проверка: команда git --version должна вернуть номер версии без ошибок.
☑️ Подготовка окружения
Шаг 2. Загрузка репозитория WebUI
Создайте папку для установки в корне диска, например C:\StableDiffusion. Важно: путь не должен содержать кириллицу, пробелы и спецсимволы — это частая причина сбоев скриптов Python. Откройте командную строку в этой папке и клонируйте репозиторий:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitПосле завершения клонирования появится папка stable-diffusion-webui со всеми файлами проекта. Скачивать ZIP-архив с GitHub вручную не рекомендуется: такая копия не привязана к репозиторию, и обновлять её через git pull не получится.
Шаг 3. Первый запуск и автоматическая установка
В корне папки проекта найдите файл webui-user.bat и запустите его двойным щелчком. Первый запуск — самый долгий: скрипт сам создаст виртуальное окружение venv, скачает нужную версию PyTorch и десятки зависимостей. В зависимости от скорости интернета и мощности ПК это занимает от 10–15 минут до часа и более.
Признак успешного завершения — строка вида Running on local URL: http://127.0.0.1:7860 в консоли. После этого откройте браузер и перейдите по адресу http://127.0.0.1:7860 — вы увидите веб-интерфейс. Само окно командной строки при этом закрывать нельзя: оно и есть работающий сервер.
⚠️ Внимание: не прерывайте первый запуск, даже если кажется, что процесс «завис». Загрузка PyTorch и моделей может долго не выводить ничего в консоль. Прерывание установки на половине часто приводит к повреждённому окружению, и проще удалить папку venv и начать заново, чем чинить её.
Шаг 4. Установка модели и первая генерация
Свежая установка WebUI может не содержать ни одной модели — без неё генерация невозможна. Модели (файлы .safetensors или .ckpt) скачиваются с тематических ресурсов, например Civitai или Hugging Face, и помещаются в папку models\Stable-diffusion внутри каталога WebUI. Предпочтительнее формат .safetensors — он считается более безопасным, так как не исполняет код при загрузке.
После добавления файла нажмите кнопку обновления рядом с выпадающим списком моделей в верхней части интерфейса и выберите загруженную модель. Для первой генерации достаточно ввести текстовый запрос (промпт) на вкладке txt2img и нажать Generate. Если видеопамяти не хватает, уменьшите разрешение изображения или добавьте параметры запуска, о которых ниже.
Полезные аргументы командной строки
Откройте webui-user.bat в текстовом редакторе и найдите строку set COMMANDLINE_ARGS=. Для карт с малым объёмом VRAM добавьте --medvram или --lowvram. Параметр --xformers включает оптимизацию внимания и снижает потребление памяти. Флаг --autolaunch автоматически открывает браузер после запуска. Применяйте параметры по одному и проверяйте результат.
Сравнение способов установки
Помимо классической ручной установки существуют альтернативы. Таблица ниже поможет выбрать подход под ваш уровень подготовки:
| Способ | Сложность | Обновления | Кому подходит |
|---|---|---|---|
| Ручная установка (Git + Python) | Средняя | Через git pull | Тем, кто хочет полный контроль |
| Готовые сборки/инсталляторы | Низкая | Зависит от сборки | Новичкам для быстрого старта |
| Облачные сервисы (Colab и аналоги) | Низкая | Не требуется | Владельцам слабых ПК |
| Docker-контейнер | Высокая | Через образ | Опытным пользователям, Linux |
Для большинства пользователей Windows оптимален первый вариант: он официально поддерживается разработчиками и даёт максимальную гибкость при установке расширений. Готовые сборки удобны, но их происхождение стоит проверять — скачивайте только из источников с хорошей репутацией.
Типичные ошибки и их решение
Разберём проблемы, с которыми чаще всего сталкиваются при установке. Если скрипт сообщает, что Python не найден, — почти наверняка при установке не была отмечена опция добавления в PATH; переустановите Python с этой галочкой. Ошибка вида «Torch is not able to use GPU» указывает на проблему с драйвером или на то, что установилась CPU-версия PyTorch; обычно помогает обновление драйвера NVIDIA и повторный запуск.
Ещё одна категория проблем — обрывы при скачивании зависимостей. Если установка прервалась, удалите папку venv внутри каталога WebUI и запустите webui-user.bat заново: окружение будет создано с нуля. Ошибки нехватки видеопамяти (CUDA out of memory) возникают уже при генерации — снизьте разрешение изображения, уменьшите размер батча или добавьте аргумент --medvram.
- 🐍 «Python is not recognized» — Python не в PATH, переустановите с галочкой Add to PATH.
- 🔥 Ошибки CUDA — обновите драйвер GPU, проверьте, что карта поддерживается.
- 📦 Обрыв загрузки зависимостей — удалите папку venv и запустите установку повторно.
- 💥 CUDA out of memory — уменьшите разрешение или добавьте --medvram в параметры запуска.
Обновление WebUI и расширения
Обновить интерфейс до свежей версии можно, выполнив в папке проекта команду git pull, после чего при следующем запуске скрипт сам подтянет изменившиеся зависимости. Перед обновлением имеет смысл сохранить папки с моделями и сгенерированными изображениями — они находятся внутри каталога проекта, и хотя git pull их не затрагивает, резервная копия никогда не лишняя.
Функциональность WebUI расширяется плагинами: ControlNet для контроля композиции, upscaler'ы, инструменты inpainting и другие. Устанавливаются они через вкладку Extensions прямо в интерфейсе — из встроенного списка или по URL репозитория. Ставьте расширения по одному и проверяйте стабильность работы после каждого: конфликты между плагинами — возможная причина падений интерфейса.
Часто задаваемые вопросы
Можно ли установить Stable Diffusion WebUI без видеокарты NVIDIA?
Технически да: существует режим работы на CPU и варианты для карт AMD, но скорость генерации на процессоре очень низкая — одно изображение может занимать десятки минут. Для комфортной работы рекомендуется именно NVIDIA с поддержкой CUDA.
Сколько места нужно на диске для установки?
Сам интерфейс с зависимостями занимает порядка 10 ГБ и более, плюс каждая модель — от 2 до 7 ГБ. Закладывайте запас минимум в 20–30 ГБ, особенно если планируете пробовать разные модели.
Безопасно ли скачивать модели со сторонних сайтов?
Файлы формата .ckpt теоретически могут содержать вредоносный код, поэтому предпочтительнее формат .safetensors. Скачивайте модели только с известных площадок вроде Civitai и Hugging Face и проверяйте файлы антивирусом.
Что делать, если webui-user.bat закрывается сразу после запуска?
Запустите файл не двойным щелчком, а из уже открытой командной строки — тогда текст ошибки останется на экране. Чаще всего причина в отсутствующем Python, Git или кириллице в пути к папке.
Как обновить WebUI до последней версии?
Откройте командную строку в папке проекта и выполните git pull, затем запустите webui-user.bat — скрипт сам обновит зависимости. Перед обновлением рекомендуется сделать резервную копию папки с моделями и настройками.