Репозиторий AUTOMATIC1111/stable-diffusion-webui на GitHub — это самый популярный интерфейс для локального запуска Stable Diffusion, и именно ошибки при клонировании репозитория или первом запуске webui-user.bat чаще всего останавливают новичков. Проект распространяется бесплатно с открытым исходным кодом, но требует корректно установленных Python, Git и совместимой видеокарты с достаточным объёмом видеопамяти.
В этом руководстве разберём, где находится официальный репозиторий, как правильно установить WebUI на Windows, какие параметры запуска помогут на слабом железе и что делать при типичных ошибках. Инструкция ориентирована на актуальную версию проекта — детали могут отличаться в зависимости от обновлений, поэтому сверяйтесь с описанием в самом репозитории.
Что такое AUTOMATIC1111 Stable Diffusion WebUI
AUTOMATIC1111 — это никнейм разработчика, создавшего графический веб-интерфейс для генерации изображений нейросетью Stable Diffusion. Сам проект написан на Python и использует фреймворк Gradio для отображения интерфейса в браузере. Вам не нужно разбираться в программировании: после установки вся работа идёт через удобные вкладки — txt2img, img2img, Extras и другие.
Ключевые возможности интерфейса:
- 🎨 Генерация изображений по текстовому описанию (txt2img) и преобразование готовых картинок (img2img).
- 🧩 Поддержка расширений (extensions): ControlNet, дополнительные апскейлеры, темы оформления.
- 📦 Загрузка пользовательских моделей в формате
.ckptи.safetensors, а также LoRA и эмбеддингов. - ⚙️ Гибкие настройки сэмплеров, шагов генерации, разрешения и параметра CFG Scale.
Исходный код открыт, и сообщество регулярно предлагает исправления через pull request. Это одна из причин, почему WebUI стал фактическим стандартом для локальной генерации изображений на ПК.
Системные требования перед установкой
Прежде чем клонировать репозиторий, убедитесь, что компьютер соответствует минимальным условиям. Главный ограничивающий фактор — видеокарта: комфортная работа возможна на GPU NVIDIA с поддержкой CUDA. На AMD и вовсе без дискретной видеокарты запуск тоже возможен, но потребует отдельных параметров и терпения.
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| Видеокарта | NVIDIA с 4 ГБ VRAM | NVIDIA с 8+ ГБ VRAM |
| Оперативная память | 8 ГБ | 16 ГБ и более |
| Свободное место на диске | от 10–20 ГБ | SSD с запасом под модели |
| ОС | Windows 10/11, Linux | Windows 10/11 64-bit |
| ПО | Python 3.10.x, Git | Python 3.10.x, Git, свежие драйверы GPU |
Обратите внимание на версию Python: проект ориентирован на ветку 3.10.x. Установка более новой или старой версии — частая причина ошибок при первом запуске. При установке Python обязательно отметьте галочку Add Python to PATH, иначе установщик WebUI не найдёт интерпретатор.
⚠️ Внимание: скачивайте репозиторий только с официального аккаунта AUTOMATIC1111 на GitHub. Сторонние «сборки» и репаки WebUI нередко содержат вредоносный код, особенно в файлах расширений и скриптах запуска.
Установка Stable Diffusion WebUI с GitHub на Windows
Процесс установки состоит из трёх этапов: установка зависимостей, клонирование репозитория и первый запуск. Весь процесс занимает от 15 минут до часа в зависимости от скорости интернета — установщик скачает необходимые библиотеки и базовые компоненты автоматически.
Сначала установите Git с официального сайта git-scm.com и Python 3.10 с python.org. Затем откройте командную строку в папке, куда хотите поставить WebUI (путь не должен содержать кириллицы и пробелов — это важно), и выполните клонирование:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitПосле завершения перейдите в созданную папку и запустите файл webui-user.bat двойным кликом. Скрипт сам создаст виртуальное окружение venv, подтянет зависимости через pip и скачает необходимые компоненты. Первый запуск может занять продолжительное время — не закрывайте окно консоли, даже если кажется, что процесс завис.
☑️ Чек-лист первой установки
Когда в консоли появится строка вида Running on local URL: http://127.0.0.1:7860, откройте этот адрес в браузере. Интерфейс WebUI готов к работе — осталось положить файл модели (например, в формате .safetensors) в папку models/Stable-diffusion и выбрать её в выпадающем списке слева вверху.
Настройка параметров запуска под ваше железо
Файл webui-user.bat можно отредактировать в любом текстовом редакторе, чтобы добавить аргументы командной строки. Найдите строку set COMMANDLINE_ARGS= и допишите нужные флаги. Это особенно актуально для видеокарт с малым объёмом видеопамяти.
Полезные аргументы:
- 🚀
--xformers— ускоряет генерацию и снижает потребление VRAM на поддерживаемых картах NVIDIA. - 💾
--medvramили--lowvram— режимы экономии видеопамяти для GPU с 4–6 ГБ и менее, ценой снижения скорости. - 🎛
--autolaunch— автоматически открывает интерфейс в браузере после запуска. - 🔊
--api— включает API, необходимое для работы некоторых расширений и внешних инструментов.
Если видеопамяти совсем мало, комбинация --lowvram --xformers обычно позволяет запустить генерацию даже на слабых картах. Точная совместимость флагов зависит от версии WebUI — актуальный список аргументов приведён в wiki репозитория.
Типичные ошибки и их решение
Большинство проблем при установке связано с окружением, а не с самим WebUI. Разберём самые частые сценарии.
«Python is not recognized» или установщик не видит Python. Причина — отсутствие Python в переменной PATH. Переустановите Python 3.10, отметив Add Python to PATH, либо добавьте путь вручную через настройки системных переменных среды. После этого перезапустите командную строку.
Ошибка при клонировании или «git не является командой». Git не установлен или не прописан в PATH. Установите его заново с настройками по умолчанию — инсталлятор сам добавляет всё необходимое.
Процесс зависает на «Installing torch» или выдаёт ошибки pip. Возможная причина — нестабильное соединение или конфликт версий. Попробуйте удалить папку venv внутри каталога WebUI и запустить webui-user.bat снова: окружение будет создано заново. Также проверьте, что версия Python именно 3.10.x.
⚠️ Внимание: не устанавливайте WebUI в системные папки вроде Program Files или на рабочий стол с кириллическим именем пользователя. Ошибки прав доступа и путей с не-ASCII символами — одна из самых частых причин, почему установка обрывается на полпути без внятного сообщения.
CUDA out of memory при генерации. Видеокарте не хватает памяти для выбранного разрешения. Уменьшите размер изображения до 512×512, снизьте batch size до 1 и добавьте флаги экономии VRAM, описанные выше.
Запуск WebUI на видеокартах AMD
На Windows поддержка AMD ограничена: обычно требуется запуск с флагами вроде --directml (через форк с поддержкой DirectML) или использование Linux с ROCm. Производительность и совместимость зависят от конкретной модели GPU, поэтому сверяйтесь с wiki репозитория и тематическими обсуждениями для вашей карты.
Обновление WebUI и управление расширениями
Обновить WebUI до свежей версии можно прямо из командной строки: перейдите в папку проекта и выполните git pull. Альтернатива — вкладка Extensions → Installed в самом интерфейсе, где есть кнопка проверки обновлений для расширений. После обновления перезапустите WebUI.
Расширения устанавливаются через вкладку Extensions → Install from URL: достаточно вставить ссылку на GitHub-репозиторий расширения. Помните, что каждое расширение — это сторонний код, который получает доступ к вашей системе, поэтому ставьте только популярные и поддерживаемые проекты.
⚠️ Внимание: после крупных обновлений WebUI часть расширений может перестать работать. Если интерфейс начал падать сразу после апдейта, временно переименуйте папку extensions и проверьте запуск без них — так вы быстро найдёте проблемный плагин методом исключения.
Часто задаваемые вопросы
Где находится официальный репозиторий AUTOMATIC1111?
На GitHub по адресу github.com/AUTOMATIC1111/stable-diffusion-webui. Именно оттуда нужно клонировать проект командой git clone — другие источники могут содержать изменённый или вредоносный код.
Можно ли запустить Stable Diffusion WebUI без видеокарты?
Технически да, через флаг --use-cpu all, но генерация одного изображения на процессоре может занимать десятки минут. Такой режим подходит только для ознакомления с интерфейсом.
Куда помещать скачанные модели?
Файлы моделей .safetensors или .ckpt кладутся в папку models/Stable-diffusion внутри каталога WebUI. LoRA-модели — в models/Lora. После добавления нажмите кнопку обновления рядом со списком моделей в интерфейсе.
Почему webui-user.bat сразу закрывается после запуска?
Чаще всего это ошибка Python или Git, но окно консоли закрывается до того, как вы успеваете её прочитать. Запустите webui-user.bat из уже открытой командной строки — тогда текст ошибки останется на экране.
Как полностью удалить WebUI?
Достаточно удалить папку проекта — WebUI не прописывает себя в системе. При желании дополнительно удалите кэш pip и Hugging Face в профиле пользователя, чтобы освободить место.