Error code 1 в Stable Diffusion: как исправить ошибку запуска

Error code 1 в Stable Diffusion чаще всего появляется в консоли при запуске webui-user.bat из сборки Automatic1111: скрипт launch.py завершается с сообщением вида Python ... exited with code 1, и веб-интерфейс так и не открывается. Сам по себе код 1 — это не диагноз, а лишь сигнал того, что Python-процесс завершился с ошибкой, поэтому настоящая причина всегда находится в строках лога выше этого сообщения.

Типичные виновники — несовместимая версия Python, отсутствующий или недоступный Git, битые зависимости в папке venv, а также проблемы с драйвером видеокарты и нехваткой видеопамяти. Ниже разберём, как прочитать лог, найти конкретную причину и устранить её без переустановки всей сборки.

Шаг 1: читаем лог выше строки с error code 1

Главное правило диагностики: строка «exited with code 1» — это следствие, а реальная ошибка описана выше в том же окне консоли. Прокрутите лог вверх и найдите первый блок с текстом Traceback, Error или RuntimeError — именно он указывает на сбойный модуль.

Обратите внимание на последние строки трейсбека. Там обычно написано что-то вроде ModuleNotFoundError, CUDA out of memory, Couldn't install torch или AssertionError: Torch is not able to use GPU. Каждая из этих формулировок ведёт к своему сценарию исправления, о которых пойдёт речь ниже.

Если окно консоли закрывается слишком быстро и прочитать лог не успеваете, откройте cmd в папке со Stable Diffusion и запустите файл вручную:

cd /d C:\stable-diffusion-webui

webui-user.bat

Так окно останется открытым после завершения скрипта, и вы сможете спокойно изучить весь вывод.

Шаг 2: проверяем версию Python

Automatic1111 рассчитан на Python 3.10.x (64-бит). Более новые ветки (3.11, 3.12 и выше) нередко вызывают конфликты при установке зависимостей, и launch.py падает с кодом 1 ещё на этапе создания окружения. Проверить установленную версию можно командой:

python --version

Если версия отличается от 3.10, установите нужную с официального сайта Python и при установке обязательно отметьте галочку Add Python to PATH. После этого проверьте, что команда python в новой консоли вызывает именно свежую версию — в системе могут сосуществовать несколько интерпретаторов, и скрипт может цепляться не к тому.

⚠️ Внимание: не удаляйте старые версии Python, если ими пользуются другие программы. Достаточно убедиться, что в переменной PATH нужная версия стоит выше, либо явно прописать путь к интерпретатору в webui-user.bat через переменную PYTHON.
📊 На каком этапе у вас возникает error code 1?
При установке зависимостей (torch, pip)
При первом запуске webui-user.bat
При загрузке модели
При генерации изображения

Шаг 3: Git и доступ к репозиториям

Launcher при запуске клонирует и обновляет несколько репозиториев через Git. Если Git не установлен, недоступен из командной строки или соединение с GitHub блокируется сетью, скрипт завершится с кодом 1 на этапе cloning ... или git pull.

  • 🔧 Проверьте наличие Git командой git --version — если система его не находит, установите Git for Windows.
  • 🌐 Убедитесь, что GitHub доступен из вашей сети: при блокировках помогает VPN или настройка прокси для Git.
  • 📁 Не размещайте папку Stable Diffusion в путях с кириллицей и пробелами — это регулярный источник сбоев при клонировании.
  • 🔄 Если обновление репозитория зависло или прервалось, удалите проблемную подпапку внутри repositories — скрипт скачает её заново.

Шаг 4: чиним окружение venv и зависимости

Повреждённое виртуальное окружение — одна из самых частых причин error code 1 после обновлений webui или неудачной установки расширений. Характерные признаки: ошибки ModuleNotFoundError, pip check failed или конфликты версий torch и torchvision.

Самый надёжный способ — пересоздать окружение. Закройте все окна Stable Diffusion, удалите папку venv в корне сборки и запустите webui-user.bat заново. Скрипт автоматически создаст чистое окружение и поставит зависимости с нуля. Процесс может занять заметное время из-за загрузки PyTorch — не прерывайте его.

☑️ Чистый перезапуск окружения

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

Если сбой начался сразу после установки конкретного расширения, временно удалите его папку из extensions — расширения подтягивают собственные зависимости и способны сломать общее окружение.

Шаг 5: видеокарта, драйверы и видеопамять

Ошибки вида AssertionError: Torch is not able to use GPU или падение с кодом 1 при загрузке модели обычно связаны с драйвером NVIDIA или нехваткой VRAM. Обновите драйвер до актуальной версии с официального сайта производителя и убедитесь, что система видит видеокарту — это можно проверить командой nvidia-smi.

При малом объёме видеопамяти добавьте в webui-user.bat в строку COMMANDLINE_ARGS подходящие флаги. Ориентируйтесь на документацию вашей сборки, типовые варианты такие:

set COMMANDLINE_ARGS=--medvram --xformers

Для совсем слабых карт используют --lowvram, а если GPU нет вовсе — режим --use-cpu all, хотя генерация на процессоре идёт очень медленно. Точный набор поддерживаемых аргументов зависит от версии webui, поэтому сверяйтесь с её вики или файлом справки.

Строка в логеВероятная причинаЧто делать
ModuleNotFoundErrorБитое окружение venvУдалить venv и перезапустить
Couldn't install torchСеть, версия PythonПроверить интернет и Python 3.10
Torch is not able to use GPUДрайвер или неподдерживаемая CUDAОбновить драйвер NVIDIA
CUDA out of memoryНехватка VRAMФлаги --medvram / --lowvram
error cloning / git failedGit или доступ к GitHubУстановить Git, проверить сеть
Почему после обновления webui всё сломалось?

Обновления Automatic1111 иногда меняют требования к версиям зависимостей, а старое окружение venv остаётся с прежними пакетами. Возникает конфликт версий, и launch.py падает с кодом 1. Лечится пересозданием venv, а при повторяющихся проблемах — откатом на предыдущий коммит webui через git checkout, если вы умеете с этим работать.

Шаг 6: если ничего не помогло

Когда пересоздание окружения и проверка Python не дали результата, переходите к более радикальным, но всё ещё безопасным мерам. Скачайте свежую копию репозитория Automatic1111 в новую папку, перенесите туда свои модели из models\Stable-diffusion и попробуйте запустить чистую установку — так вы отделите проблемы сборки от проблем системы.

⚠️ Внимание: не запускайте webui от имени администратора без необходимости и не ставьте сборку в системные каталоги вроде Program Files — ограничения прав в таких путях могут мешать созданию файлов и вызывать сбои с кодом 1.
  • 💾 Сохраните полный текст лога — по нему в сообществах (GitHub Issues, профильные форумы) вам смогут подсказать точное решение.
  • 🧩 Отключите антивирус на время установки зависимостей или добавьте папку в исключения: защитники иногда блокируют скачивание пакетов pip.
  • 🔍 Проверьте свободное место на диске — загрузка PyTorch и моделей требует десятки гигабайт.

Частые вопросы

Что означает error code 1 в Stable Diffusion?

Это стандартный код выхода Python-процесса, завершившегося с ошибкой. Сам по себе он ничего не диагностирует — конкретную причину нужно искать в строках лога выше, обычно в блоке Traceback.

Поможет ли переустановка Stable Diffusion?

Да, если проблема в повреждённых файлах сборки или окружении. Но сначала попробуйте удалить только папку venv — в большинстве случаев этого достаточно, и полная переустановка не понадобится.

Какая версия Python нужна для Automatic1111?

Рекомендуется Python 3.10.x 64-бит. Более новые ветки могут быть несовместимы с частью зависимостей, из-за чего установка пакетов обрывается и launch.py завершается с кодом 1.

Ошибка появляется только при генерации, а интерфейс открывается. Это то же самое?

Нет. Если веб-интерфейс загружается, а сбой происходит при генерации, причина обычно в нехватке видеопамяти, повреждённом файле модели или слишком большом разрешении. Попробуйте другую модель, уменьшите разрешение и добавьте флаг --medvram.

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

Да, через режим CPU с аргументом --use-cpu all, но генерация будет очень медленной. Для карт AMD существуют отдельные сборки и инструкции — они отличаются от стандартной установки под NVIDIA, поэтому сверяйтесь с документацией конкретного форка.