Репозиторий AUTOMATIC1111 Stable Diffusion WebUI на GitHub — это самый популярный способ запустить генерацию изображений нейросетью Stable Diffusion на локальном компьютере, и первое, что нужно проверить перед установкой, — наличие видеокарты NVIDIA с достаточным объёмом видеопамяти и актуальных драйверов. Без этого веб-интерфейс либо не запустится, либо будет работать в крайне медленном режиме на CPU.
Проект распространяется бесплатно и с открытым исходным кодом. Он представляет собой веб-интерфейс на базе Gradio, который оборачивает сложные Python-скрипты в удобную панель с вкладками: txt2img, img2img, inpainting, обучение эмбеддингов и десятки других функций. Ниже разберём установку, настройку и типичные проблемы.
Что представляет собой репозиторий AUTOMATIC1111
Репозиторий github.com/AUTOMATIC1111/stable-diffusion-webui — это не сама нейросеть, а оболочка для работы с моделями семейства Stable Diffusion. Код написан на Python, интерфейс открывается в браузере по локальному адресу, а все вычисления выполняются на вашем железе. Проект поддерживается сообществом: расширения, фиксы и новые функции добавляются регулярно.
Ключевые возможности интерфейса:
- 🎨 Генерация изображений по текстовому описанию (txt2img) и по референсу (img2img)
- 🖌️ Inpainting и outpainting — дорисовка и расширение изображений
- 🧩 Поддержка расширений: ControlNet, LoRA, upscaler'ы и сотни других
- ⚙️ Гибкая настройка сэмплеров, шагов, CFG Scale и разрешения
- 📦 API-режим для интеграции с внешними программами
Важно понимать: сам репозиторий не содержит весов модели — их нужно скачивать отдельно, например с Civitai или Hugging Face, и помещать в папку models/Stable-diffusion. Без файла модели интерфейс запустится, но генерировать изображения не сможет.
Системные требования перед установкой
Прежде чем клонировать репозиторий, убедитесь, что компьютер соответствует минимальным требованиям. Основной фактор — видеокарта. Для комфортной работы желательна NVIDIA с поддержкой CUDA; на картах AMD и встроенной графике запуск возможен, но с оговорками и дополнительной настройкой.
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| Видеокарта | NVIDIA с 4 ГБ VRAM | NVIDIA с 8+ ГБ VRAM |
| Оперативная память | 8 ГБ | 16 ГБ и более |
| Свободное место на диске | 20 ГБ | 50+ ГБ (модели занимают много места) |
| ОС | Windows 10/11, Linux | Windows 10/11 64-bit |
| Python | 3.10.x | 3.10.x (ставится автоматически в venv) |
Если видеопамяти мало, не отчаивайтесь: интерфейс поддерживает флаги оптимизации --medvram и --lowvram, которые снижают потребление VRAM ценой скорости. Подробнее о флагах — в разделе про запуск.
Пошаговая установка на Windows
Установка сводится к трём шагам: установить Git и Python, клонировать репозиторий, запустить скрипт. Сначала поставьте Git с официального сайта и Python 3.10 — при установке Python обязательно отметьте галочку Add Python to PATH, иначе скрипт не найдёт интерпретатор.
Затем откройте командную строку в папке, куда хотите установить программу, и выполните клонирование:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitПосле этого перейдите в созданную папку и запустите файл webui-user.bat двойным кликом. При первом запуске скрипт сам создаст виртуальное окружение, скачает PyTorch и все зависимости — это может занять продолжительное время в зависимости от скорости интернета. По завершении в консоли появится строка с адресом вида http://127.0.0.1:7860 — откройте её в браузере.
☑️ Проверка перед первым запуском
⚠️ Внимание: не устанавливайте WebUI в папки с кириллицей или пробелами в пути — например, в «Документы» с русским именем пользователя. Это частая причина ошибок при установке зависимостей. Используйте простой путь вроде C:\stable-diffusion\.
Первый запуск и загрузка модели
Когда интерфейс открылся в браузере, вам нужно выбрать модель в выпадающем списке в левом верхнем углу. Если список пуст — проверьте, что файл модели лежит именно в models/Stable-diffusion и имеет расширение .safetensors или .ckpt. После добавления файла нажмите кнопку обновления рядом со списком.
Для первой генерации достаточно ввести текстовый промпт на вкладке txt2img и нажать Generate. Параметры по умолчанию вполне рабочие: 20 шагов, сэмплер Euler a или DPM++ 2M Karras, разрешение 512×512 для моделей SD 1.5. Дальше можно экспериментировать с настройками.
Если генерация занимает неприлично много времени, проверьте в консоли, не используется ли CPU вместо GPU. Строка запуска обычно указывает, какое устройство выбрано. Работа на процессоре в десятки раз медленнее — это верный признак проблемы с PyTorch или драйверами.
Флаги командной строки и оптимизация
Поведение WebUI настраивается через аргументы командной строки, которые прописываются в файле webui-user.bat в строке COMMANDLINE_ARGS. Необходимо добавлять флаги только при реальной нужде — лишние параметры могут замедлить работу.
- 🚀
--xformers— ускоряет генерацию и снижает потребление VRAM на картах NVIDIA - 💾
--medvram— режим экономии видеопамяти для карт с 4–6 ГБ - 🐢
--lowvram— крайняя экономия VRAM, заметно медленнее - 🌐
--listen— открывает доступ к интерфейсу из локальной сети - 🔌
--api— включает REST API для внешних программ
Пример строки в webui-user.bat:
set COMMANDLINE_ARGS=--xformers --medvramУстановка расширений и ControlNet
Главная сила AUTOMATIC1111 — экосистема расширений. Они устанавливаются прямо из интерфейса: вкладка Extensions → Install from URL, куда вставляется ссылка на GitHub-репозиторий расширения. После установки требуется перезапуск интерфейса кнопкой Apply and restart UI.
Самое востребованное расширение — ControlNet, позволяющее управлять композицией генерации через позы, глубину, контуры и другие направляющие. Учтите, что для ControlNet нужно отдельно скачивать файлы управляющих моделей и помещать их в папку расширения.
Где брать модели и расширения
Модели (чекпоинты и LoRA) чаще всего скачивают с Civitai и Hugging Face. Расширения ищутся на вкладке Extensions → Available прямо в интерфейсе или на GitHub. Перед установкой проверяйте совместимость с вашей версией WebUI и предпочитайте формат .safetensors — он безопаснее .ckpt, так как не может содержать исполняемый код.
⚠️ Внимание: скачивайте модели только в формате.safetensorsи только с проверенных источников. Файлы.ckptоснованы на pickle и теоретически могут содержать вредоносный код, который выполнится при загрузке модели.
Типичные ошибки и их решения
Большинство проблем при работе с WebUI связано с окружением Python, драйверами или нехваткой памяти. Разберём самые частые сценарии.
Ошибка «CUDA out of memory» означает, что видеопамяти не хватает для текущих параметров. Снизьте разрешение изображения, уменьшите batch size до 1 или добавьте флаг --medvram. Также закройте браузеры и программы, занимающие VRAM.
Ошибки при установке зависимостей (например, конфликты pip) часто решаются удалением папки venv внутри каталога WebUI и повторным запуском webui-user.bat — окружение будет создано заново. Если скрипт сообщает, что не найден Python, проверьте версию командой python --version: должна быть ветка 3.10.x.
Чёрные картинки на выходе на некоторых конфигурациях возникают из-за вычислений в half precision. Возможное решение — добавить флаги --no-half и --precision full, хотя это увеличит расход VRAM. Поведение зависит от конкретной видеокарты, поэтому экспериментируйте по одному флагу за раз.
⚠️ Внимание: не обновляйте WebUI через git pull посреди важной работы, если у вас установлено много расширений. Обновления иногда ломают совместимость, и откат потребует ручного восстановления версий. Делайте резервную копию папки перед крупными обновлениями.
FAQ: частые вопросы
Можно ли запустить WebUI без видеокарты NVIDIA?
Да, но с ограничениями. На картах AMD под Windows работа возможна через DirectML-форк, а под Linux — через ROCm, если карта поддерживается. Запуск только на CPU технически возможен с флагом --use-cpu all, но генерация одного изображения займёт очень много времени.
Куда помещать скачанные модели?
Чекпоинты — в models/Stable-diffusion, LoRA — в models/Lora, VAE — в models/VAE. После добавления файлов нажмите кнопку обновления в интерфейсе или перезапустите WebUI.
Как обновить Stable Diffusion WebUI до последней версии?
Откройте командную строку в папке WebUI и выполните git pull. Зависимости при необходимости обновятся при следующем запуске webui-user.bat. Перед обновлением рекомендуется сделать копию папки.
Почему интерфейс открывается, но генерация не начинается?
Чаще всего не выбрана или не загружена модель — проверьте выпадающий список чекпоинтов. Также посмотрите консоль: там отображаются ошибки загрузки весов, нехватки памяти или отсутствия файлов.
Безопасно ли скачивать модели со сторонних сайтов?
Формат .safetensors считается безопасным, так как не допускает исполнения кода. Файлы .ckpt потенциально могут содержать вредоносный payload — скачивайте их только из источников, которым доверяете, и предпочитайте safetensors-версии.