Как исправить ошибку 'Unable to find path' при запуске Kokoro TTS на Windows: полное руководство

Когда путь пропадает: почему Kokoro TTS не запускается на Windows

Вы скачали Kokoro TTS, распаковали архив, запустили run_gradio.bat - и получили зловещее сообщение 'Unable to find path'. Командная строка мигает на секунду и исчезает. Весь энтузиазм по поводу локального синтеза речи испаряется. Знакомо? Я тоже через это проходил.

Что на самом деле происходит под капотом

Когда вы кликаете по run_gradio.bat, Windows пытается выполнить команду python app.py. И вот здесь начинается цирк. Система ищет интерпретатор Python, но не находит его. Почему? Потому что установщик Python не добавил себя в PATH, или добавил, но вам нужно перезапустить терминал, или вы установили Python через магазин Windows (да, это отдельная песня).

1 Диагностика проблемы: что сломалось на этот раз

Первое правило борьбы с ошибками - понять, что именно сломалось. Откройте run_gradio.bat в блокноте. Скорее всего, вы увидите что-то вроде:

@echo off
python app.py
pause

Проблема в том, что Windows не знает, где искать python.exe. Давайте это проверим.

Откройте командную строку (Win + R, введите cmd, Enter) и выполните:

where python

Если команда ничего не возвращает - у вас нет Python в PATH. Если возвращает несколько путей - могут быть конфликты версий. Если возвращает один путь, но запуск все равно не работает - возможно, у вас установлен только магазинный Python (Microsoft Store).

2 Установка правильного Python (если еще не поздно)

Если у вас нет Python или стоит только магазинная версия, удалите ее. Да, удалите. Сейчас объясню.

Идите на python.org, скачивайте последнюю версию 3.11 (не 3.12!). Почему 3.11? Потому что многие библиотеки машинного обучения, включая зависимости Kokoro TTS, еще не обновились под 3.12. Выбираете версию под свою архитектуру (скорее всего, Windows installer (64-bit)).

Вот самый важный момент в установке:

[x] Add python.exe to PATH

Эта галочка должна быть отмечена. Если вы ее пропустили в прошлый раз - вот ваша ошибка. Я видел десятки случаев, когда люди устанавливали Python без этой галочки, а потом удивлялись, почему ничего не работает.

3 Правка run_gradio.bat: от грубой силы к элегантному решению

Теперь вернемся к нашему злосчастному bat-файлу. Есть несколько способов его починить.

Способ 1: Явное указание пути к Python

Найдите, где у вас установлен Python. Обычно это C:\Users\ВашеИмя\AppData\Local\Programs\Python\Python311\ или C:\Python311\. Откройте run_gradio.bat и замените первую строку:

@echo off
"C:\Users\ВашеИмя\AppData\Local\Programs\Python\Python311\python.exe" app.py
pause

Но этот способ хрупкий. Если вы переустановите Python или перенесете проект на другой компьютер - снова ошибка.

Способ 2: Использование py - более умный вариант

В современных версиях Python для Windows идет утилита py.exe, которая живет в C:\Windows\ и всегда доступна. Меняем bat-файл:

@echo off
py -3.11 app.py
pause

py автоматически найдет установленный Python 3.11. Если у вас другая версия - укажите ее.

Способ 3: Создание виртуального окружения (профессиональный подход)

Этот способ решает не только проблему с путем, но и потенциальные конфликты библиотек. Создайте новый bat-файл с таким содержимым:

@echo off

REM Создаем виртуальное окружение, если его нет
if not exist "venv" (
    echo Creating virtual environment...
    python -m venv venv
)

REM Активируем виртуальное окружение
call venv\Scripts\activate.bat

REM Устанавливаем зависимости
if not exist "requirements_installed.txt" (
    echo Installing requirements...
    pip install -r requirements.txt
    echo 1 > requirements_installed.txt
)

REM Запускаем приложение
echo Starting Kokoro TTS...
python app.py

pause

Этот скрипт создает изолированное окружение, устанавливает зависимости один раз и запускает приложение. Больше никаких конфликтов с другими проектами.

Частые ошибки, которые идут вместе с 'Unable to find path'

Обычно проблемы не приходят поодиночке. Вот что еще может сломаться:

Ошибка с torch или CUDA

Если после исправления пути вы получаете ошибки импорта torch, значит, у вас неправильная версия PyTorch. Kokoro TTS часто требует специфичной сборки.

Попробуйте установить PyTorch вручную:

pip uninstall torch torchvision torchaudio -y
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

Это установит PyTorch с поддержкой CUDA 11.8. Если у вас нет NVIDIA GPU, используйте CPU-версию:

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

Отсутствующие системные библиотеки

Некоторые зависимости требуют Visual C++ Redistributable. Скачайте и установите Visual C++ Redistributable для Visual Studio 2015-2022.

Проблемы с правами доступа

Windows любит блокировать выполнение скриптов из неизвестных источников. Если bat-файл вообще не запускается, проверьте:

Get-ExecutionPolicy

Если вернет Restricted, выполните от имени администратора:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Альтернатива: запуск через PowerShell

Если bat-файлы вызывают у вас аллергию, создайте run_gradio.ps1:

# Проверяем Python
if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
    Write-Host "Python not found in PATH" -ForegroundColor Red
    exit 1
}

# Создаем виртуальное окружение
if (-not (Test-Path "venv")) {
    Write-Host "Creating virtual environment..." -ForegroundColor Yellow
    python -m venv venv
}

# Активируем
& .\venv\Scripts\Activate.ps1

# Устанавливаем зависимости
if (-not (Test-Path "requirements_installed.txt")) {
    Write-Host "Installing requirements..." -ForegroundColor Yellow
    pip install -r requirements.txt
    "1" | Out-File -FilePath "requirements_installed.txt"
}

# Запускаем
Write-Host "Starting Kokoro TTS..." -ForegroundColor Green
python app.py

Write-Host "Press any key to continue..."
$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")

Запускайте его правой кнопкой -> "Запустить с помощью PowerShell".

Когда ничего не помогает: ядерные варианты

Если вы перепробовали все, а Kokoro TTS все равно не запускается, есть крайние меры.

Вариант 1: Docker

Установите Docker Desktop для Windows. Создайте Dockerfile:

FROM python:3.11-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "app.py"]

И запустите:

docker build -t kokoro-tts .
docker run -p 7860:7860 kokoro-tts

Docker создаст изолированное окружение со всеми зависимостями. Это тяжеловесное решение, но оно работает почти всегда. Если интересно, как использовать Docker для других AI-проектов, посмотрите мой гайд про создание аудиокниг с удаленным GPU.

Вариант 2: WSL 2

Установите Windows Subsystem for Linux 2, поставьте там Ubuntu и запускайте Kokoro TTS в Linux-окружении. Это дает доступ ко всем прелестям Linux-пакетного менеджера без переустановки системы.

Профилактика будущих проблем

Чтобы не сталкиваться с подобными ошибками в других проектах:

1. Всегда отмечайте "Add Python to PATH" при установке
2. Используйте виртуальные окружения для каждого проекта
3. Проверяйте совместимость версий Python с требованиями проекта
4. Для AI-проектов предпочитайте Python 3.10 или 3.11
5. Держите Visual C++ Redistributable актуальным

Если вы планируете работать с несколькими TTS-решениями, ознакомьтесь со сравнением open-source моделей - это поможет выбрать подходящий инструмент под ваши задачи.

Финальный чек-лист перед запуском

Когда все галочки проставлены - запускайте run_gradio.bat. Если видите запускающийся Gradio интерфейс - вы победили. Если нет - пишите в комментариях, разберемся вместе.

И последнее: если вы устали бороться с окружением для каждого AI-проекта, возможно, стоит посмотреть в сторону готовых one-click установщиков. Иногда проще использовать готовое решение, чем тратить часы на настройку.

Теперь вы знаете не только как исправить 'Unable to find path', но и почему эта ошибка возникает. Следующий проект на Python установится с первого раза. Ну, или со второго.