Двойной клик по webui-user.bat открывает консоль на пару секунд, после чего окно мгновенно закрывается — это самый частый симптом, с которым сталкиваются пользователи Stable Diffusion WebUI от AUTOMATIC1111. Причина почти всегда скрыта в тексте ошибки, который не успевает прочитаться, поэтому первое действие — запустить файл через командную строку, чтобы консоль осталась открытой и показала сообщение об ошибке.
Для этого откройте папку со Stable Diffusion, зажмите Shift, кликните правой кнопкой по пустому месту в окне проводника и выберите «Открыть окно PowerShell здесь». Затем введите команду и нажмите Enter:
.\webui-user.batТеперь текст ошибки останется на экране. Ниже разобраны типовые причины, из-за которых Stable Diffusion не запускается, и способы их устранения — от самых простых к более глубоким.
Python не установлен или не прописан в PATH
WebUI требует конкретную версию интерпретатора — Python 3.10.x. Если в консоли видны сообщения вроде Python is not recognized или Couldn't launch python, значит система не находит интерпретатор. Это происходит, когда Python не установлен вовсе либо при установке не был отмечен чекбокс Add Python to PATH.
Проверьте, что видит система. Выполните в командной строке:
python --versionЕсли команда возвращает ошибку или версию ветки 3.11/3.12/3.13, установите Python 3.10 с официального сайта проекта, обязательно отметив галочку добавления в PATH в первом окне установщика. После установки перезагрузите компьютер, чтобы переменные окружения обновились.
⚠️ Внимание: новые версии Python (3.11 и выше) несовместимы с зависимостями WebUI — часть пакетов просто не соберётся. Ставьте именно ветку 3.10, даже если система предлагает свежий релиз.
- 🐍 Проверьте версию командой
python --version - 📥 Установите Python 3.10.x с официального сайта
- ✅ Отметьте Add python.exe to PATH при установке
- 🔄 Перезагрузите ПК после установки
Ошибки Git и проблемы с клонированием репозиториев
Вторая по частоте причина — отсутствие Git или невозможность скачать зависимые репозитории. В консоли это выглядит как 'git' is not recognized либо ошибки вида Failed to clone repository и Connection timed out при скачивании.
Установите Git для Windows с официального сайта проекта, оставив параметры установщика по умолчанию. Если Git уже стоит, но клонирование падает по таймауту — проверьте соединение: возможная причина в блокировке со стороны провайдера, антивируса или корпоративного прокси. Попробуйте временно отключить VPN либо, наоборот, включить его, если доступ к GitHub ограничен.
Зависание на Installing requirements
Строка Installing requirements... может висеть десятки минут или обрываться ошибкой pip. Здесь возможных причин несколько: медленное или нестабильное соединение, устаревший pip, конфликт версий пакетов или недостаток места на диске — зависимости вместе с PyTorch занимают несколько гигабайт.
Начните с простого: убедитесь, что на системном диске свободно хотя бы 15–20 ГБ, и обновите pip внутри виртуального окружения. Откройте консоль в папке webui и выполните:
venv\Scripts\python.exe -m pip install --upgrade pipЕсли установка стабильно падает на одном и том же пакете, полностью удалите папку venv в каталоге webui — при следующем запуске webui-user.bat пересоздаст виртуальное окружение и скачает зависимости заново. Это безопасная операция: ваши модели, настройки и сгенерированные изображения находятся в других папках и не пострадают.
☑️ Чек-лист при зависании на Installing requirements
Ошибки torch, CUDA и видеокарты
Сообщения вроде CUDA out of memory, no kernel image is available или Torch is not able to use GPU указывают на проблемы с видеокартой или несовместимую сборку PyTorch. Для работы WebUI нужна карта NVIDIA с поддержкой CUDA либо запуск на CPU, что крайне медленно.
Сначала обновите драйвер NVIDIA до актуальной версии с официального сайта производителя — старые драйверы часто не поддерживают свежие сборки PyTorch. Если видеокарта слабая (мало видеопамяти), добавьте в файл webui-user.bat параметры запуска в строку COMMANDLINE_ARGS:
set COMMANDLINE_ARGS=--lowvram --xformersПараметр --lowvram снижает потребление видеопамяти ценой скорости, --medvram — промежуточный вариант. Для запуска без GPU используется флаг --skip-torch-cuda-test вместе с --use-cpu all, но генерация на процессоре займёт минуты даже на простых изображениях.
| Ошибка в консоли | Вероятная причина | Что проверить |
|---|---|---|
| Python is not recognized | Python не в PATH | Переустановить Python 3.10 с галочкой PATH |
| 'git' is not recognized | Git не установлен | Установить Git для Windows |
| RuntimeError: Couldn't install torch | Несовместимая версия Python или pip | Версия Python 3.10, обновить pip, удалить venv |
| CUDA out of memory | Не хватает видеопамяти | Флаги --lowvram / --medvram |
| Torch is not able to use GPU | Старый драйвер или сборка CPU | Обновить драйвер NVIDIA |
WebUI запустился, но страница не открывается
Иногда консоль доходит до строки Running on local URL: http://127.0.0.1:7860, но браузер не открывается или показывает «Не удается получить доступ к сайту». В этом случае вручную введите в адресной строке http://127.0.0.1:7860 — интерфейс должен загрузиться, если сервер действительно работает.
Если страница недоступна, возможная причина — занятый порт или блокировка брандмауэром. Проверьте, не запущен ли уже один экземпляр WebUI в фоне: закройте лишние окна консоли и проверьте диспетчер задач на наличие процессов python.exe. Также можно сменить порт через параметр --port 7861 в COMMANDLINE_ARGS.
⚠️ Внимание: не закрывайте окно консоли, пока работаете с WebUI — это и есть сервер. Сворачивайте его, но не закрывайте, иначе интерфейс в браузере перестанет отвечать.
Как запустить WebUI с логом в файл
Добавьте в конец строки запуска перенаправление вывода: webui-user.bat > log.txt 2>&1 — весь текст консоли сохранится в файл log.txt, который удобно изучить или приложить к вопросу на форуме.
Антивирус, права доступа и путь установки
Менее очевидная группа причин — окружение, в котором лежит сама папка WebUI. Антивирусы иногда блокируют скачивание и исполнение скриптов из каталога webui, а путь с кириллицей или пробелами способен ломать отдельные скрипты установки зависимостей.
Разместите папку по простому пути вроде C:\stable-diffusion-webui — без русских букв, пробелов и спецсимволов. Добавьте каталог в исключения антивируса, если замечаете, что файлы пропадают после скачивания. Запуск от имени администратора обычно не требуется, но и не помешает при проблемах с правами на запись.
- 📁 Используйте короткий путь без кириллицы и пробелов
- 🛡️ Добавьте папку webui в исключения антивируса
- 💾 Не ставьте WebUI в системные каталоги вроде Program Files
- 👤 При ошибках доступа попробуйте запуск от имени администратора
Частые вопросы
Какая версия Python нужна для Stable Diffusion WebUI?
Требуется Python ветки 3.10.x. Версии 3.11 и новее несовместимы с частью зависимостей WebUI, поэтому установка свежего релиза приведёт к ошибкам сборки пакетов. Проверить текущую версию можно командой python --version.
Окно консоли закрывается мгновенно — как увидеть ошибку?
Запустите webui-user.bat не двойным кликом, а из открытой командной строки или PowerShell: тогда окно не закроется, и текст ошибки останется на экране. Альтернатива — перенаправить вывод в файл: webui-user.bat > log.txt 2>&1.
Удалятся ли мои модели, если удалить папку venv?
Нет. В папке venv находится только виртуальное окружение Python с библиотеками. Модели лежат в models\Stable-diffusion, сгенерированные изображения — в outputs, настройки — в config.json. Удаление venv затрагивает только зависимости, которые скачаются заново.
Можно ли запустить WebUI без видеокарты NVIDIA?
Да, через параметры --skip-torch-cuda-test --use-cpu all в COMMANDLINE_ARGS, но генерация на процессоре идёт очень медленно. Для карт AMD существуют отдельные сборки и инструкции — их стоит искать в документации проекта под вашу конкретную конфигурацию.
WebUI работал, а после обновления перестал запускаться. Что делать?
Обновления иногда ломают совместимость с установленными расширениями. Попробуйте запуск с флагом --disable-all-extensions: если WebUI стартовал, причина в одном из расширений — обновите их или удалите проблемное из папки extensions. Также помогает удаление venv для чистой переустановки зависимостей.