Stable Diffusion WebUI: полное руководство по установке и настройке

Ошибка torch is not able to use GPU при первом запуске Stable Diffusion WebUI почти всегда означает, что установлена CPU-версия PyTorch либо драйвер NVIDIA устарел — генерация в этом случае идёт на процессоре и занимает минуты вместо секунд. Проверка начинается с пункта Settings → Device или строки лога при старте webui-user.bat.

Stable Diffusion WebUI (в среде пользователей — AUTOMATIC1111, по имени автора репозитория) — это браузерный интерфейс для локальной генерации изображений нейросетью Stable Diffusion. Программа бесплатна, работает офлайн после установки и поддерживает расширения: от ControlNet до обучения собственных LoRA. Ниже разберём установку, базовую настройку и решение типичных проблем.

Системные требования и подготовка

Главное требование — видеокарта с достаточным объёмом видеопамяти. Комфортная работа возможна на GPU NVIDIA с 6–8 ГБ VRAM и выше; на 4 ГБ генерация возможна с флагами экономии памяти, но с ограничениями по разрешению. Карты AMD поддерживаются через специальные сборки (DirectML или ROCm под Linux), однако настройка там сложнее и менее предсказуема.

Помимо видеокарты понадобятся:

  • 🐍 Python 3.10.x — именно ветка 3.10, другие версии часто ломают зависимости;
  • 📦 Git — для клонирования репозитория и обновлений;
  • 💾 20–40 ГБ свободного места на диске под модели и окружение;
  • 🖥️ актуальный драйвер NVIDIA с сайта производителя.
⚠️ Внимание: путь к папке установки не должен содержать кириллицу и пробелы — это частая причина ошибок вида ModuleNotFoundError при запуске. Используйте путь вроде C:\stable-diffusion\.

Пошаговая установка на Windows

Стандартный способ — установка из официального репозитория AUTOMATIC1111 на GitHub. Сначала клонируйте репозиторий в выбранную папку, затем запустите скрипт, который сам создаст виртуальное окружение и скачает зависимости.

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git

cd stable-diffusion-webui

webui-user.bat

Первый запуск длится долго — скачиваются PyTorch и базовые компоненты. По завершении в консоли появится адрес http://127.0.0.1:7860, который нужно открыть в браузере. Сама модель (checkpoint, файл .safetensors или .ckpt) скачивается отдельно — например, с ресурсов вроде Hugging Face или Civitai — и кладётся в папку models/Stable-diffusion.

☑️ Проверка перед первым запуском

Выполнено: 0 / 5

Ключевые параметры запуска

Аргументы командной строки прописываются в файле webui-user.bat в строке COMMANDLINE_ARGS. Они определяют, как WebUI распределяет видеопамять и какие функции включает.

АргументНазначениеКогда применять
--medvramЭкономия VRAM за счёт скоростиКарты с 4–6 ГБ памяти
--lowvramМаксимальная экономия памятиОчень слабые GPU, медленная генерация
--xformersОптимизация внимания, ускорениеПочти всегда на NVIDIA
--autolaunchАвтооткрытие браузераПо желанию
--apiВключение REST APIИнтеграция с внешними программами

Подбирайте флаги по одному и проверяйте результат: если после добавления аргумента появляется ошибка CUDA out of memory или, наоборот, генерация стала медленнее без причины — откатите изменение. Сочетание --xformers без флагов экономии памяти — оптимальный старт для карт с 8 ГБ VRAM и больше.

📊 На какой видеокарте вы запускаете Stable Diffusion WebUI?
NVIDIA 8+ ГБ VRAM
NVIDIA 4–6 ГБ VRAM
AMD
Только CPU / ещё не установил

Интерфейс и базовая генерация

Вкладка txt2img — точка входа для большинства задач. В поле Prompt вводится описание изображения, в Negative prompt — то, чего на картинке быть не должно. Ключевые настройки: Sampling method (алгоритм сэмплирования, например DPM++ 2M Karras), Steps (число шагов, обычно 20–30 достаточно) и CFG Scale (насколько строго следовать промпту, типичный диапазон 5–9).

Вкладка img2img позволяет изменять готовые изображения: загрузите картинку, задайте Denoising strength — чем выше значение, тем сильнее результат отличается от оригинала. Там же находятся инструменты inpaint для точечной перерисовки областей.

Расширения и модели

Функциональность WebUI расширяется через вкладку Extensions: расширения ставятся из встроенного каталога или по ссылке на GitHub. Наиболее востребованные:

  • 🎛️ ControlNet — управление композицией по позе, глубине, эскизу;
  • 🔍 ADetailer — автоматическое исправление лиц и рук;
  • 🧩 LoRA и Textual Inversion — компактные дообученные модели для стилей и персонажей;
  • 📈 Ultimate SD Upscale — увеличение разрешения без потери деталей.
⚠️ Внимание: расширения выполняют сторонний код на вашем компьютере. Ставьте их только из известных репозиториев и обновляйте осторожно — конфликт версий расширений частая причина, почему WebUI перестаёт запускаться после обновления.
Где брать модели и как их различать

Checkpoints (полные модели) весят 2–7 ГБ и определяют общий стиль генерации. LoRA — небольшие файлы (обычно до нескольких сотен МБ), подключаемые поверх базовой модели через синтаксис <lora:имя:вес> в промпте. VAE отвечает за цветопередачу — если картинки выглядят блёклыми, попробуйте подключить внешний VAE в Settings → Stable Diffusion.

Типичные ошибки и их решение

CUDA out of memory — видеокарте не хватило памяти. Снизьте разрешение, уменьшите batch size до 1, добавьте --medvram. Если не помогло — --lowvram.

Веб-интерфейс не открывается. Проверьте, не занят ли порт 7860 другим процессом, и не блокирует ли брандмауэр. Попробуйте открыть адрес http://127.0.0.1:7860 вручную в другом браузере.

Ошибки при установке зависимостей чаще всего связаны с неверной версией Python. Удалите папку venv внутри каталога WebUI, убедитесь, что python --version показывает 3.10.x, и запустите webui-user.bat заново — окружение пересоздастся автоматически.

Если после обновления всё сломалось, откатитесь на предыдущий коммит через Git: git checkout <хеш_коммита>. Рабочие версии удобно фиксировать заранее.

FAQ

Можно ли запускать Stable Diffusion WebUI без видеокарты NVIDIA?

Да, но с оговорками. CPU-режим работает очень медленно. Для AMD существуют сборки с DirectML (Windows) и ROCm (Linux), однако их настройка сложнее, а совместимость расширений ниже — сверяйтесь с документацией конкретной сборки.

Куда сохраняются сгенерированные изображения?

По умолчанию в папку outputs внутри каталога WebUI, с разделением по вкладкам (txt2img-images, img2img-images). Путь можно изменить в настройках.

Почему лицо на генерации выглядит искажённым?

Типичные причины: малое разрешение (лицо занимает мало пикселей) или слишком мало шагов. Помогают увеличение разрешения, функция Restore faces или расширение ADetailer.

Как обновить WebUI до последней версии?

Выполните git pull в папке установки либо просто запустите webui-user.bat — при стандартной конфигурации обновление происходит автоматически. Перед обновлением имеет смысл сохранить копию рабочей папки.

Безопасно ли скачивать модели с Civitai?

Формат .safetensors считается безопасным, так как не исполняет код. Файлы .ckpt (pickle) теоретически могут содержать вредоносный код — предпочитайте safetensors и проверяйте репутацию автора.