Руководство WhisperX
Установка WhisperX: подготовка среды и диагностика
Изолированная среда Python, CPU или совместимый GPU и FFmpeg по актуальной документации проекта.
Команда WhisperX · Проверено 15 октября 2026 г.
Проверьте актуальные требования
Перед выбором Python, PyTorch и CUDA прочитайте README выбранной версии. Зависимости меняются; это руководство не гарантирует, что все команды проверены именно на вашей системе.
Изолируйте среду
Создайте новую виртуальную среду и сохраните версию программы и зависимости. Для воспроизводимости используйте инструкции стабильного выпуска.
Проверьте CPU, GPU и FFmpeg
Можно работать на CPU. Для GPU нужны совместимые драйверы и библиотеки; одной установки CUDA недостаточно. FFmpeg читает распространённые медиаформаты. Начните с короткого файла.
Настройте разделение говорящих после расшифровки
Сначала проверьте распознавание и выравнивание. Затем настройте доступ к моделям по исходной документации, примите условия со своего аккаунта и храните токены вне репозитория.
Устраняйте проблемы по очереди
Команда не найдена — проверьте среду; ошибка CUDA — драйверы и библиотеки; нехватка памяти — размер пакета; отказ в доступе — разрешения. Удаляйте токены и приватные пути из публикуемых журналов.
Выберите место запуска
Локальная установка даёт контроль над настройками и расположением данных. Облачный сервис берёт обслуживание среды на себя, чтобы вы могли сосредоточиться на загрузке, проверке и экспорте результата.
python -m venv .venv
# Активируйте .venv командой для вашей оболочки
python -m pip install --upgrade pip
python -m pip install whisperx
whisperx recording.wav --device cpu --compute_type int8