При первом запуске Automatic1111 Stable Diffusion Web UI чаще всего всё упирается в одну и ту же связку: скрипт webui-user.bat завершается с ошибкой Python, не находит Git или ругается на отсутствующую видеокарту с поддержкой CUDA. Это не значит, что программа «не работает на вашем ПК» — почти всегда причина в неподготовленном окружении: не той версии Python, отсутствующем Git или устаревших драйверах NVIDIA.
В этом руководстве разберём, что такое Stable Diffusion Web UI от AUTOMATIC1111, какие требования предъявляются к системе, как правильно установить интерфейс на Windows, подключить модели и разобраться с типичными ошибками запуска. Материал ориентирован на локальный запуск на собственном компьютере — без облачных сервисов.
Что такое Automatic1111 Web UI и зачем он нужен
AUTOMATIC1111 Web UI — это самый популярный графический интерфейс с открытым исходным кодом для локальной генерации изображений с помощью моделей Stable Diffusion. Проект распространяется бесплатно через репозиторий на GitHub и работает в браузере, хотя все вычисления выполняются локально на вашей видеокарте.
Интерфейс поддерживает основные режимы работы: txt2img (генерация по текстовому описанию), img2img (преобразование исходного изображения), inpainting (дорисовка выделенных областей), upscaling (увеличение разрешения) и огромную экосистему расширений — от ControlNet до обучения собственных LoRA-моделей.
Системные требования и подготовка
До начала установки проверьте три вещи: видеокарту, версию Python и наличие Git. Пропуск любого из этих пунктов — самая частая причина, почему установка «виснет» или падает с ошибкой.
- 🎮 Видеокарта NVIDIA с поддержкой CUDA и желательно от 4 ГБ видеопамяти — чем больше VRAM, тем комфортнее работа. Запуск на AMD и CPU возможен, но требует отдельных параметров и работает заметно медленнее.
- 🐍 Python 3.10.x — именно эту ветку рекомендует проект. При установке обязательно отметьте галочку
Add Python to PATH, иначе скрипт не найдёт интерпретатор. - 🌿 Git for Windows — нужен для клонирования репозитория и обновлений. Без него команда
git cloneне выполнится. - 💾 Свободное место на диске — сам интерфейс занимает немного, но каждая модель весит от 2 до 7 ГБ, поэтому запас в 20–30 ГБ будет разумным минимумом.
⚠️ Внимание: не устанавливайте Python 3.12 или новее «на всякий случай» — часть зависимостей Web UI может быть с ними несовместима. Если в системе уже стоит другая версия, проверьте, какая из них прописана в переменной PATH командой python --version в командной строке.
Пошаговая установка на Windows
Установка сводится к клонированию репозитория и запуску bat-файла — остальное скрипт сделает сам при первом старте. Выполняйте шаги по порядку.
Откройте командную строку в папке, куда хотите поставить программу (путь не должен содержать кириллицы и пробелов — это частая причина сбоев), и выполните:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
Затем перейдите в созданную папку и запустите файл webui-user.bat двойным кликом. Первый запуск может занять продолжительное время: скрипт создаст виртуальное окружение, скачает PyTorch и остальные зависимости. Не закрывайте окно, пока в консоли не появится строка вида Running on local URL: http://127.0.0.1:7860 — это адрес, по которому интерфейс откроется в браузере.
☑️ Контрольный список первого запуска
Загрузка и подключение моделей
Свежая установка Web UI поставляется без моделей, поэтому генерация сразу не заработает. Файл модели (чекпоинт) нужно скачать отдельно — распространённые источники в сообществе это Hugging Face и Civitai. Формат файла обычно .safetensors или .ckpt; предпочтителен safetensors, так как он безопаснее.
Скачанный файл поместите в папку stable-diffusion-webui/models/Stable-diffusion. После этого нажмите кнопку обновления рядом с выпадающим списком моделей в левом верхнем углу интерфейса — новая модель появится в списке. Необязательные компоненты раскладываются по своим каталогам:
| Тип файла | Назначение | Папка размещения |
|---|---|---|
| Checkpoint (.safetensors) | Основная модель генерации | models/Stable-diffusion |
| VAE | Улучшение цветопередачи | models/VAE |
| LoRA | Тонкая стилистическая настройка | models/Lora |
| Embedding | Текстовые инверсии для промптов | embeddings |
Что такое VAE и нужен ли он
VAE (вариационный автоэнкодер) отвечает за декодирование изображения из латентного пространства. Некоторые чекпоинты содержат VAE внутри, другие без него выдают блёклые, сероватые картинки. Если цвета выглядят «вымытыми», попробуйте подключить внешний VAE в настройках интерфейса (раздел Stable Diffusion, пункт SD VAE).
Базовые настройки генерации
Чтобы получить первый результат, вам нужно заполнить поле Prompt — текстовое описание желаемого изображения на английском языке — и при желании Negative prompt, куда вносят то, чего на картинке быть не должно. Затем нажмите кнопку Generate.
Ключевые параметры, которые влияют на результат сильнее всего:
- 🎲 Sampling method — алгоритм сэмплирования. Для начала подойдут популярные варианты вроде Euler a или DPM++ 2M Karras.
- 🔢 Sampling steps — количество шагов генерации. Больше шагов — дольше время, но не всегда лучше качество; разумный диапазон для экспериментов — 20–30.
- 📐 Width / Height — разрешение изображения. Классические модели обучены на 512×512, и сильное отклонение от этого размера может давать артефакты.
- 🎚️ CFG Scale — насколько строго модель следует промпту. Слишком высокие значения «пережигают» картинку.
- 🌱 Seed — зерно генерации. Значение -1 даёт случайный результат; фиксированный seed позволяет воспроизвести понравившееся изображение.
Типичные ошибки и их решение
Ошибка CUDA out of memory означает, что видеокарте не хватило видеопамяти для текущей задачи. Проверьте разрешение генерации и размер батча — снизьте их. Если проблема повторяется даже на минимальных настройках, откройте файл webui-user.bat в текстовом редакторе и допишите в строку COMMANDLINE_ARGS параметр --medvram, а в тяжёлых случаях — --lowvram. Эти флаги снижают потребление VRAM ценой скорости.
Если скрипт сообщает, что Python не найден или git is not recognized, причина почти наверняка в переменной PATH: переустановите компонент с отмеченной опцией добавления в PATH или пропишите путь вручную в системных переменных среды Windows. После изменения PATH обязательно перезапустите командную строку.
⚠️ Внимание: не редактируйте файлы внутри папкиvenvи не удаляйте её «для очистки», пока идёт установка зависимостей — прерванная установка приводит к битым пакетам. Если подозреваете повреждение окружения, удалите папкуvenvцеликом и запуститеwebui-user.batзаново: окружение будет создано с нуля.
Ещё одна встречающаяся ситуация — чёрный квадрат вместо изображения. Возможная причина — включённая защита NSFW-фильтра либо проблемы с вычислениями в половинной точности на старых картах; во втором случае пробуют параметры --no-half и --precision full. Поскольку поведение зависит от конкретной видеокарты, применяйте флаги по одному и проверяйте результат.
Обновление и расширения
Обновить Web UI до свежей версии можно командой git pull, выполненной в папке проекта, либо через bat-файл обновления, если он присутствует в вашей сборке. Перед обновлением имеет смысл сохранить папки models, outputs и embeddings — там лежат ваши модели и сгенерированные изображения.
Функциональность расширяется через вкладку Extensions: там доступна установка дополнений из встроенного каталога или по ссылке на репозиторий. Устанавливайте расширения по одному и перезапускайте интерфейс после каждого — так проще понять, какое из них вызвало конфликт, если что-то пойдёт не так.
⚠️ Внимание: расширения выполняются с правами вашей системы и могут содержать произвольный код. Ставьте дополнения только из известных репозиториев с открытым исходным кодом и не запускайте Web UI с флагом --share или открытым сетевым доступом без понимания рисков.
Часто задаваемые вопросы
Можно ли запустить Automatic1111 без видеокарты NVIDIA?
Да, возможны запуск на CPU (параметр --use-cpu all) и на картах AMD через соответствующие сборки, но скорость генерации будет значительно ниже, а настройка — сложнее. Для комфортной работы сообщество чаще всего использует карты NVIDIA с поддержкой CUDA.
Почему в консоли зависла загрузка torch при первом запуске?
PyTorch — крупный пакет, и его скачивание может занять много времени на медленном соединении. Если прогресс не движется очень долго, проверьте стабильность интернета и свободное место на диске, затем прерванную установку можно начать заново — pip докачает недостающее.
Где сохраняются сгенерированные изображения?
По умолчанию результаты складываются в папку outputs внутри каталога Web UI, с разделением по режимам: txt2img-images, img2img-images и так далее. Путь можно изменить в настройках интерфейса.
Как перенести установку на другой диск?
Папку проекта можно переместить целиком — Web UI не привязан к конкретному пути, но следите, чтобы новый путь не содержал кириллицы и пробелов. После переноса при первом запуске может потребоваться пересоздание окружения: удалите папку venv и запустите webui-user.bat снова.
Безопасно ли скачивать модели с Civitai и Hugging Face?
Формат .safetensors считается безопасным, так как не допускает исполнения произвольного кода при загрузке. Файлы .ckpt основаны на pickle и теоретически могут содержать вредоносный код — отдавайте предпочтение safetensors-версиям и скачивайте модели только с известных площадок.