# WhisperKey

Нативная глобальная диктовка для macOS:

- `F5` — локальный whisper.cpp с полной несжатой моделью large-v3-turbo;
- `Option+F5` — OpenAI Speech-to-Text API;
- модель постоянно загружена в фоновом локальном сервере, поэтому не перечитывается с диска после каждого F5;
- локальный F5 распознаёт перекрывающиеся окна примерно раз в 1,25 секунды и вставляет слова, совпавшие в двух последовательных проходах;
- нестабильный хвост остаётся внутри приложения до следующего прохода, поэтому ошибочная короткая гипотеза не попадает в поле;
- облачный Option+F5 сохраняет прежние крупные фрагменты и не создаёт дополнительные платные запросы;
- изолированных коротких запросов нет: каждый локальный проход получает перекрывающееся окно контекста до 7,5 секунды;
- после 5 секунд тишины запись завершается автоматически, повторное нажатие останавливает её вручную;
- результат очищается и вставляется в активное текстовое поле;
- OpenAI API key хранится в macOS Keychain.

## Установка

```bash
chmod +x scripts/*.sh
./scripts/setup-local-whisper.sh
./scripts/install-app.sh
```

При первом запуске разрешите:

1. доступ к микрофону;
2. управление компьютером в «Конфиденциальность и безопасность → Универсальный доступ».

Отключите штатное действие F5:

`Системные настройки → Клавиатура → Диктовка → Сочетание клавиш`.

API-ключ добавляется через значок WhisperKey в строке меню → «Настройки».

## Данные

Локальный режим не отправляет запись в сеть. Облачный режим отправляет временный WAV-файл в OpenAI API; после ответа временные аудиофайлы удаляются.