Установка Stable Diffusion WebUI чаще всего обрывается на этапе первого запуска webui-user.bat: консоль зависает на загрузке репозиториев, выдаёт ошибку Python или сообщает о нехватке видеопамяти. Причина почти всегда кроется в неподходящей версии Python, отсутствии Git или слабой видеокарте без поддержки CUDA.
В этом материале разберём, что представляет собой Stable Diffusion WebUI (проект AUTOMATIC1111), какие требования предъявляются к системе, как выполнить установку шаг за шагом и что делать с типичными ошибками. Инструкция ориентирована на Windows, но большинство принципов применимы и к Linux.
Что такое WebUI для Stable Diffusion
Stable Diffusion WebUI — это графический интерфейс на базе Gradio, который позволяет генерировать изображения нейросетью Stable Diffusion без написания кода. Проект распространяется бесплатно и с открытым исходным кодом, а его репозиторий размещён на GitHub.
Интерфейс открывается в браузере по локальному адресу, обычно http://127.0.0.1:7860. Вся обработка выполняется на вашем компьютере: изображения не отправляются на внешние серверы, а ограничения по количеству генераций отсутствуют. Это ключевое отличие от облачных сервисов.
- 🎨 Генерация по текстовому описанию (txt2img) и по исходному изображению (img2img)
- 🧩 Поддержка расширений: ControlNet, upscaler-модели, LoRA
- ⚙️ Гибкая настройка сэмплеров, шагов и параметра CFG Scale
- 📦 Локальное хранение моделей и результатов
Системные требования
Минимальные требования зависят от того, планируете ли вы генерацию на видеокарте или на процессоре. Работа на CPU возможна, но крайне медленная, поэтому ориентироваться стоит на GPU.
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| Видеокарта | NVIDIA с 4 ГБ VRAM | NVIDIA с 8+ ГБ VRAM |
| Оперативная память | 8 ГБ | 16 ГБ и более |
| Свободное место на диске | 20 ГБ | 50+ ГБ (SSD) |
| Python | 3.10.x | 3.10.x (64-bit) |
| Git | Обязателен | Последняя стабильная версия |
Обратите внимание: WebUI официально рассчитан на Python 3.10.x — версии 3.11 и новее часто вызывают конфликты зависимостей. Если в системе установлено несколько версий Python, убедитесь, что нужная прописана в переменной PATH.
⚠️ Внимание: видеокарты AMD и Intel на Windows поддерживаются ограниченно и требуют альтернативных сборок (например, ветки с DirectML). Производительность и стабильность могут заметно отличаться — сверяйтесь с документацией конкретной сборки.
Пошаговая установка на Windows
Процесс установки состоит из четырёх этапов: подготовка окружения, загрузка репозитория, первый запуск и установка модели. Ниже — подробный порядок действий.
Сначала установите Python 3.10 с официального сайта python.org. При установке обязательно отметьте галочку Add Python to PATH — без этого скрипт запуска не найдёт интерпретатор. Затем установите Git с сайта git-scm.com, используя настройки по умолчанию.
Далее откройте командную строку в папке, куда хотите поставить WebUI, и выполните клонирование репозитория:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitПосле завершения загрузки перейдите в созданную папку и запустите файл webui-user.bat двойным кликом. При первом запуске скрипт автоматически создаст виртуальное окружение и скачает зависимости — это может занять продолжительное время в зависимости от скорости интернета.
☑️ Проверка перед первым запуском
Последний шаг — скачать файл модели (checkpoint), например с ресурса Civitai или Hugging Face, и поместить его в папку models/Stable-diffusion. Без модели интерфейс запустится, но генерация будет невозможна.
Настройка после установки
После запуска откройте в браузере адрес, указанный в консоли. Интерфейс разделён на вкладки: txt2img, img2img, Extras, Settings и другие. Основная работа ведётся на первой вкладке.
Что стоит настроить в первую очередь: выберите загруженную модель в выпадающем списке в левом верхнем углу, задайте разрешение изображения (для базовых моделей SD 1.5 типично 512×512) и подберите сэмплер. Параметр CFG Scale определяет, насколько строго нейросеть следует текстовому описанию, а Steps — количество итераций генерации.
В разделе Settings → User interface можно включить отображение дополнительных элементов, а на вкладке Extensions — установить расширения из встроенного каталога. Не устанавливайте много расширений сразу: конфликты между ними — частая причина сбоев.
Аргументы командной строки для слабых видеокарт
Если у вас 4 ГБ VRAM или меньше, попробуйте добавить в COMMANDLINE_ARGS параметр --medvram или --lowvram. Они снижают потребление видеопамяти ценой скорости генерации. Также полезен --opt-split-attention на системах без xformers.
Типичные ошибки и их решения
Самая распространённая проблема — ошибка CUDA out of memory. Она означает, что видеокарте не хватило памяти для генерации с текущими настройками. Решение: уменьшите разрешение изображения, снизьте размер батча до 1 или добавьте аргументы экономии VRAM, описанные выше.
Ошибка вида Python is not recognized указывает, что интерпретатор не найден в PATH. Переустановите Python с отмеченной опцией добавления в PATH или пропишите путь вручную в системных переменных среды. Если консоль зависает на этапе Cloning..., возможная причина — проблемы с доступом к GitHub: проверьте соединение и настройки прокси или VPN.
- 🔴 ModuleNotFoundError — повреждено виртуальное окружение; удалите папку
venvи перезапустите скрипт - 🔴 Чёрный квадрат вместо изображения — возможная причина в конфликте с вычислениями половинной точности; попробуйте аргумент
--no-halfили--precision full - 🔴 Интерфейс не открывается в браузере — проверьте, что порт 7860 не занят другой программой и не блокируется брандмауэром
⚠️ Внимание: не редактируйте файлы внутри папки venv и не обновляйте библиотеки вручную через pip — это нарушает совместимость зависимостей. Для обновления WebUI используйте команду git pull в папке проекта.
Обновление и обслуживание
Для обновления WebUI до свежей версии откройте командную строку в папке проекта и выполните:
git pullПосле обновления скрипт при следующем запуске сам подтянет изменённые зависимости. Если после обновления появились ошибки, возможная причина — несовместимость установленных расширений с новой версией. Отключите их временно, добавив аргумент --disable-all-extensions, и включайте по одному, чтобы найти конфликтующее.
Периодически очищайте папку outputs, если генерируете много изображений, — она быстро разрастается. Модели и LoRA храните в соответствующих подпапках models, чтобы интерфейс корректно их распознавал.
Альтернативы AUTOMATIC1111
Помимо классического WebUI существуют другие интерфейсы для Stable Diffusion. ComfyUI использует узловую (нодовую) систему построения пайплайна и считается более экономным по памяти, но требует привыкания. Fooocus ориентирован на простоту: минимум настроек и автоматический подбор параметров для новичков.
Выбор зависит от задач. Если нужны расширения вроде ControlNet и тонкий контроль генерации — AUTOMATIC1111 остаётся наиболее документированным вариантом с большим сообществом. Для экспериментов со сложными цепочками обработки удобнее ComfyUI.
Где искать модели и как проверять их безопасность
Основные источники — Civitai и Hugging Face. Скачивайте файлы в формате safetensors: в отличие от устаревшего формата ckpt, он не позволяет встроить исполняемый код в файл модели. Перед использованием читайте описание модели: там указаны рекомендуемые настройки и триггерные слова.
Часто задаваемые вопросы
Можно ли запустить WebUI без видеокарты NVIDIA?
Да, но с оговорками. Возможен запуск на процессоре с аргументом --use-cpu all, однако генерация одного изображения займёт очень много времени. Для карт AMD существуют отдельные сборки с поддержкой DirectML или ROCm (на Linux) — их стабильность зависит от конкретной модели GPU и версии драйверов.
Почему при первом запуске скачивается несколько гигабайт данных?
Скрипт устанавливает PyTorch с поддержкой CUDA и ряд библиотек машинного обучения — это нормально. Загрузка происходит один раз; последующие запуски выполняются быстро, если папка venv не повреждена.
Как перенести WebUI на другой диск?
Достаточно переместить всю папку проекта целиком — виртуальное окружение и модели переносятся вместе с ней. Убедитесь, что в новом пути нет кириллицы и пробелов: это возможная причина сбоев при запуске скриптов.
Чем safetensors отличается от ckpt?
Оба формата содержат веса модели, но safetensors считается безопаснее: формат не допускает выполнение произвольного кода при загрузке. При выборе между двумя версиями одной модели предпочтительнее safetensors.
WebUI запускается, но генерация идёт очень медленно. Что проверить?
Убедитесь, что используется GPU, а не CPU: в консоли при старте не должно быть сообщений о fallback на процессор. Проверьте, что установлены свежие драйверы NVIDIA, и попробуйте включить xformers. Также снизьте разрешение и количество шагов для теста.