Ошибка Couldn't launch python или сообщение «Python is not recognized as an internal or external command» при запуске webui-user.bat означает, что установщик Stable Diffusion WebUI от AUTOMATIC1111 не находит интерпретатор Python в системе. В большинстве случаев проблема сводится к трём причинам: Python не установлен, установлена несовместимая версия или путь к нему не прописан в переменной окружения PATH.
Ниже разберём, как проверить каждую из этих причин и устранить ошибку без переустановки всей связки. Инструкция ориентирована на Windows 10/11, поскольку именно под ней чаще всего запускают AUTOMATIC1111 WebUI, но логика диагностики применима и к другим сборкам.
Проверка: установлен ли Python вообще
Начните с простейшей диагностики. Откройте командную строку (Win + R → cmd) и введите:
python --versionЕсли система отвечает чем-то вроде Python 3.10.11 — интерпретатор установлен и виден в PATH, и проблему нужно искать глубже. Если появляется сообщение, что команда не распознана, или открывается магазин Microsoft Store, значит, Python либо отсутствует, либо не добавлен в переменные окружения.
Дополнительно проверьте альтернативные вызовы — иногда интерпретатор доступен под другим именем:
py --version
where python
Команда where python покажет все пути, по которым система находит исполняемый файл. Пустой результат — однозначный признак того, что PATH не настроен.
Почему WebUI не находит Python: основные причины
Скрипт webui.bat при запуске ищет Python по цепочке: сначала проверяет переменную окружения PYTHON, затем обращается к системному PATH. Если ни там, ни там интерпретатора нет, запуск обрывается с ошибкой. Разберём типовые сценарии.
- 🔧 Python не установлен — самый банальный случай после чистой установки Windows.
- 📦 Пропущен флажок «Add Python to PATH» при установке — интерпретатор есть, но система его не видит.
- 🔢 Неподходящая версия — WebUI рассчитан на Python 3.10.x; слишком новые версии (3.12+) вызывают конфликты зависимостей, а очень старые не поддерживаются.
- 🗂️ Конфликт нескольких установок — например, Python из Microsoft Store перехватывает вызов и мешает обычной версии.
- 🔒 Антивирус или права доступа блокируют запуск интерпретатора из папки проекта.
⚠️ Внимание: заглушка Python из Microsoft Store — частая скрытая причина. Даже если вы установили Python с официального сайта, в PATH может стоять путь к заглушке
WindowsApps, которая вместо запуска открывает магазин. Проверьте это черезwhere python: если первым в списке идёт путь с WindowsApps, его нужно отключить в настройках «Псевдонимы выполнения приложений».
Установка правильной версии Python
Для стабильной работы Stable Diffusion WebUI ориентируйтесь на ветку Python 3.10 — именно под неё проверена совместимость большинства зависимостей проекта, включая PyTorch. Скачивать установщик следует только с официального сайта python.org, раздел загрузок для Windows.
При установке обязательно отметьте галочку Add python.exe to PATH в самом первом окне установщика — это избавит от ручной настройки переменных окружения. После установки перезапустите командную строку и повторите проверку версии.
☑️ Правильная установка Python для Stable Diffusion
Если Python уже установлен, но без PATH, переустанавливать его не обязательно: запустите тот же установщик, выберите Modify и включите добавление в PATH, либо пропишите путь вручную — об этом ниже.
Ручное добавление Python в PATH
Когда установщик уже отработал, путь можно прописать вручную через настройки системы. Откройте Win + R → sysdm.cpl → вкладка «Дополнительно» → кнопка «Переменные среды». В разделе пользовательских или системных переменных найдите Path и добавьте туда два пути:
C:\Users\ИмяПользователя\AppData\Local\Programs\Python\Python310\
C:\Users\ИмяПользователя\AppData\Local\Programs\Python\Python310\Scripts\
Точные пути зависят от того, куда вы ставили Python, — сверьте их с реальным расположением папки установки. После сохранения закройте все окна командной строки и откройте новую: переменные окружения подхватываются только при запуске нового процесса.
Указание Python напрямую в webui-user.bat
Самый надёжный способ, не зависящий от состояния системных переменных, — явно указать путь к интерпретатору в файле запуска. Откройте webui-user.bat в папке WebUI любым текстовым редактором и найдите строку с переменной PYTHON. Раскомментируйте её и пропишите полный путь:
set PYTHON=C:\Users\ИмяПользователя\AppData\Local\Programs\Python\Python310\python.exeЭтот метод особенно полезен, когда в системе стоит несколько версий Python: WebUI будет использовать именно ту, которую вы указали, игнорируя остальные. Явное указание пути в webui-user.bat устраняет ошибку «не видит Python» даже при полностью сломанном системном PATH.
⚠️ Внимание: путь к python.exe не должен содержать кириллицы и пробелов в критичных местах, либо должен быть заключён в кавычки. Установка Python в папку вида
C:\Мои Программы\— почти гарантированный источник ошибок запуска.
Проблемы с виртуальным окружением venv
Иногда Python находится нормально, но ошибка возникает на следующем этапе — при создании виртуального окружения venv. Симптомы: скрипт останавливается с сообщениями об ошибках pip или не может активировать окружение. Типичное решение — удалить папку venv внутри каталога WebUI и запустить webui-user.bat заново: окружение будет создано с нуля.
Если ошибка повторяется, проверьте, не блокирует ли антивирус создание скриптов в папке проекта, и запускается ли bat-файл от имени пользователя с достаточными правами. Также убедитесь, что сама папка Stable Diffusion расположена по пути без кириллицы — например, C:\stable-diffusion-webui.
| Текст ошибки | Вероятная причина | Что делать |
|---|---|---|
| Python is not recognized | Python нет в PATH | Добавить путь в PATH или прописать set PYTHON |
| Couldn't launch python | Неверный путь в webui-user.bat | Проверить и исправить путь к python.exe |
| Открывается Microsoft Store | Заглушка из WindowsApps | Отключить псевдонимы приложений |
| Ошибка создания venv | Повреждённое окружение или антивирус | Удалить папку venv, проверить блокировки |
| Конфликт зависимостей pip | Неподходящая версия Python | Установить Python 3.10.x |
Проверка Git и финальный запуск
После того как Python определяется, скрипт запуска потребует ещё и Git — без него WebUI не сможет клонировать репозитории расширений. Проверьте его командой git --version. Если Git не установлен, скачайте его с официального сайта git-scm.com и при установке оставьте стандартные настройки PATH.
Затем запустите webui-user.bat двойным кликом. Первый запуск занимает заметное время: скачиваются зависимости, включая PyTorch, поэтому длительная «замирание» консоли на скачивании пакетов — нормальное явление, а не зависание. При успешном старте в консоли появится локальный адрес вида http://127.0.0.1:7860, который открывается в браузере.
Что делать, если ошибка сохраняется после всех шагов
Создайте чистый тест: откройте cmd, выполните python -c "import sys; print(sys.executable)" и убедитесь, что путь ведёт к нужной установке. Затем полностью удалите папку venv, проверьте отсутствие кириллицы в пути к проекту и запустите webui-user.bat из командной строки (а не двойным кликом) — так вы увидите полный текст ошибки, который обычно обрезается при закрытии окна.
Частые вопросы
Какая версия Python нужна для Stable Diffusion WebUI?
Ориентируйтесь на ветку Python 3.10.x — она считается наиболее совместимой с зависимостями AUTOMATIC1111 WebUI. Более новые версии могут вызывать ошибки установки пакетов.
Можно ли использовать Python из Microsoft Store?
Не рекомендуется: версия из Store имеет ограничения на доступ к файловой системе и часто конфликтует с venv. Лучше установить классический дистрибутив с python.org и отключить псевдонимы Store-заглушки.
Зачем нужна строка set PYTHON, если Python уже в PATH?
Она задаёт приоритетный интерпретатор конкретно для WebUI. Это полезно, когда в системе несколько версий Python и нужно гарантировать, что проект использует именно 3.10.
Ошибка появляется только при запуске от имени администратора — почему?
У администратора и обычного пользователя могут быть разные переменные PATH. Проверьте, что путь к Python добавлен в системные переменные среды, а не только в пользовательские.
Нужно ли переустанавливать Stable Diffusion после смены Python?
Полная переустановка не требуется. Достаточно удалить папку venv в каталоге проекта — при следующем запуске окружение пересоздастся под новый интерпретатор, а модели и настройки сохранятся.