Ошибка «Couldn't launch python» в Stable Diffusion WebUI (AUTOMATIC1111) появляется сразу после запуска файла webui-user.bat и означает, что установщик не смог найти или запустить интерпретатор Python на компьютере. Чаще всего скрипт останавливается на строке exit code: 9009 или сообщает, что команда python не распознана системой.
Проблема почти всегда связана не с самой нейросетью, а с окружением: отсутствующим Python, неправильной версией, непрописанной переменной PATH или повреждённой папкой виртуального окружения venv. Ниже разберём каждую причину и дадим безопасный порядок действий — от простых проверок к полной переустановке.
Почему возникает ошибка Couldn't launch Python
Скрипт запуска webui-user.bat при старте ищет команду python в системе. Если интерпретатор не найден, не подходит по версии или недоступен из командной строки, запуск прерывается с характерным сообщением.
- 🐍 Python не установлен вообще или установлен не для всех пользователей системы.
- 📁 Python не добавлен в PATH — при установке не был отмечен флажок Add Python to PATH.
- 🔢 Неподходящая версия — WebUI рассчитан на конкретную ветку Python (как правило, 3.10.x), а в системе стоит слишком новая или старая версия.
- 🗂️ Повреждённая папка venv — виртуальное окружение создалось с ошибкой после обрыва установки.
- 🛡️ Антивирус или права доступа блокируют запуск интерпретатора из папки пользователя.
⚠️ Внимание: не скачивайте Python со сторонних сайтов и «сборок». Используйте только официальный установщик с python.org — модифицированные дистрибутивы часто не содержат нужных модулей и вызывают те же ошибки.
Проверка: установлен ли Python и видит ли его система
Первое действие — убедиться, что система вообще находит интерпретатор. Откройте командную строку и выполните простую проверку.
python --versionЕсли в ответ появляется номер версии (например, Python 3.10.11) — интерпретатор установлен и доступен. Если видите сообщение «python не является внутренней или внешней командой» — система его не находит, и это главный кандидат на причину ошибки.
Также проверьте альтернативную команду py --version — в Windows может работать лаунчер py, даже когда команда python недоступна. Расхождение результатов указывает именно на проблему с PATH, а не на отсутствие Python.
Решение 1: правильная установка Python
Если Python отсутствует или версия не подходит, переустановите его с нуля. Для стабильной работы AUTOMATIC1111 WebUI рекомендуется Python 3.10.x — на новых ветках (3.12 и выше) часть зависимостей может не собираться.
Порядок действий:
- ⬇️ Скачайте установщик Python 3.10 для Windows (64-bit) с официального сайта python.org.
- ☑️ На первом экране установщика обязательно поставьте галочку
Add python.exe to PATH— без неё ошибка повторится. - 👤 Выбирайте установку для текущего пользователя, если нет прав администратора.
- 🔄 После установки перезагрузите компьютер, чтобы переменные окружения обновились.
Решение 2: ручное добавление Python в PATH
Когда Python установлен, но команда python не работает, путь к интерпретатору нужно прописать вручную. Откройте Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды.
В списке пользовательских переменных найдите Path, нажмите «Изменить» и добавьте две строки: путь к папке с python.exe и путь к подпапке Scripts. Обычно это выглядит примерно так (точный путь зависит от вашей установки):
C:\Users\Имя\AppData\Local\Programs\Python\Python310\
C:\Users\Имя\AppData\Local\Programs\Python\Python310\Scripts\
После сохранения закройте и заново откройте командную строку — старые окна терминала не подхватывают изменения. Повторите проверку python --version.
☑️ Проверка перед повторным запуском WebUI
Решение 3: удаление повреждённого venv и указание Python вручную
Если Python в порядке, но ошибка сохраняется, виновник — папка виртуального окружения. Перейдите в каталог stable-diffusion-webui и удалите папку venv целиком. При следующем запуске скрипт создаст окружение заново.
Дополнительно можно явно указать, какой интерпретатор использовать. Откройте файл webui-user.bat в текстовом редакторе и раскомментируйте строку с переменной PYTHON, прописав полный путь:
set PYTHON=C:\Users\Имя\AppData\Local\Programs\Python\Python310\python.exeЭто особенно полезно, когда в системе стоит несколько версий Python и скрипт цепляется не к той. Сохраните файл и запустите webui-user.bat снова.
Что делать, если папка venv не удаляется
Закройте все окна командной строки и редакторы кода, которые могли держать файлы окружения открытыми. Если удаление всё равно блокируется, перезагрузите компьютер и удалите папку сразу после входа в систему, до запуска других программ.
Сводная таблица причин и решений
| Симптом | Вероятная причина | Решение |
|---|---|---|
| «python не является командой» | Python не в PATH | Переустановка с галочкой PATH или ручное добавление пути |
| Ошибка сразу при первом запуске | Python не установлен | Установка Python 3.10.x с python.org |
| Работало, сломалось после обновления | Повреждён venv | Удалить папку venv и запустить заново |
| В системе несколько версий Python | Скрипт берёт не ту версию | Прописать set PYTHON в webui-user.bat |
| Ошибка прав доступа при создании venv | Антивирус или ограничения папки | Добавить папку WebUI в исключения защитника |
⚠️ Внимание: не запускайте webui-user.bat от имени администратора «на всякий случай» — созданное с повышенными правами окружение потом может конфликтовать с обычным запуском. Используйте права администратора только если без них установка действительно блокируется.
Дополнительные проверки, если ничего не помогло
Убедитесь, что установлен Git — скрипт WebUI вызывает его для загрузки компонентов, и его отсутствие иногда маскируется под ошибки запуска. Проверка выполняется командой git --version.
Также проверьте путь к папке stable-diffusion-webui: в нём не должно быть кириллицы и пробелов в нестандартных местах. Путь вида C:\stable-diffusion-webui надёжнее, чем расположение в «Документах» с русскими символами в имени пользователя.
Наконец, временно добавьте папку проекта в исключения антивируса и Защитника Windows — известны случаи, когда защитник молча блокировал создание исполняемых файлов внутри venv, и установка зависимостей обрывалась на середине.
Часто задаваемые вопросы
Какая версия Python нужна для Stable Diffusion WebUI?
Рекомендуемая ветка — Python 3.10.x. Более новые версии могут вызывать ошибки при сборке зависимостей, а старые не поддерживаются скриптом установки.
Ошибка появляется с кодом 9009 — что это значит?
Код 9009 в Windows означает «команда не найдена». В контексте WebUI это почти всегда указывает на то, что система не видит команду python — проверяйте установку и переменную PATH.
Нужно ли удалять старую версию Python перед установкой 3.10?
Не обязательно — несколько версий могут сосуществовать. Главное, чтобы в PATH приоритет был у нужной версии, либо пропишите путь к ней явно через set PYTHON в файле webui-user.bat.
После удаления venv установка зависает на скачивании — это нормально?
Первое создание окружения подразумевает загрузку большого объёма библиотек, включая PyTorch, поэтому процесс может занять продолжительное время и выглядеть «зависшим». Дождитесь завершения и следите за сообщениями об ошибках в консоли.
Можно ли запускать WebUI через Anaconda или Miniconda?
Можно, но стандартный скрипт рассчитан на обычный Python. При использовании conda потребуется вручную создать окружение с Python 3.10 и запускать WebUI из него — это вариант для опытных пользователей.