# Whisper: установка и запуск

Ниже локальная установка официального openai-whisper. Ориентир для окружения — Python 3.11, входящий в диапазон совместимости, указанный в [README проекта](https://github.com/openai/whisper). Первому запуску нужен интернет для скачивания модели; распознавание затем выполняется на твоём компьютере.

## Windows

1. Установи Python 3.11 и pip с [python.org](https://www.python.org/downloads/). Проверь в новом терминале: `py -3.11 --version`.
2. Установи FFmpeg. Если уже есть Chocolatey, выполни `choco install ffmpeg`. Другой путь: возьми сборку по ссылкам со [страницы FFmpeg](https://ffmpeg.org/download.html), распакуй её и добавь каталог `bin` в пользовательский PATH.
3. Открой новый терминал и проверь: `ffmpeg -version`.
4. В папке для работы выполни команды. Активация окружения не требуется — указан полный путь к программе внутри него.

```bat
py -3.11 -m venv .venv
.venv\Scripts\python.exe -m pip install -U openai-whisper
.venv\Scripts\whisper.exe "video.mp4" --model small --language Russian --output_format srt --output_dir subtitles
```

В командах выше обратные слеши обозначают обычные разделители пути Windows. После распаковки используй команды из файла command_windows.txt, где они записаны готовыми для вставки.

## macOS

1. Установи Python 3.11 с [python.org](https://www.python.org/downloads/), если его ещё нет.
2. При установленном [Homebrew](https://brew.sh/) запусти `brew install ffmpeg`, затем `ffmpeg -version`.
3. В рабочей папке выполни:

```sh
python3.11 -m venv .venv
.venv/bin/python -m pip install -U openai-whisper
.venv/bin/whisper "video.mp4" --model small --language Russian --output_format srt --output_dir subtitles
```

Заменяй video.mp4 на свой путь. Папка subtitles появится автоматически. Скорость зависит от модели, процессора или видеокарты и длины записи. Если нет ускорителя, распознавание может занять заметное время.

## После запуска

Проверь, что subtitles/video.srt появился и не пустой. Импортируй его в редактор с поддержкой SRT. Оформление и переносы строк подбирай в редакторе, затем сверь распознанную речь с оригиналом.

example.srt — вручную написанный учебный пример формата, не результат обработки реального видео. PROMPT.txt — задание для создания скрипта обработки папки.

Параметры вывода: [Whisper CLI](https://github.com/openai/whisper/blob/main/whisper/transcribe.py). Ограничения распознавания: [model card](https://github.com/openai/whisper/blob/main/model-card.md).