Vox — голосовой ввод для Windows

Зажми клавишу, говори, отпусти — текст появится там, где курсор. В любом приложении.

Vox — десктопное приложение для голосового ввода, которое работает полностью офлайн. Без облака, без отправки голоса куда-либо, без ежемесячных платежей за базовый функционал.

📣 Новости и обратная связь — в Telegram-канале @privatekey_ai.

---

✨ Возможности

Ядро

• Push-to-talk в любом окне — зажал клавишу → говоришь → отпустил → текст у курсора. Работает в браузере, IDE, мессенджере, терминале — везде.
• Parakeet TDT v3 — одна модель на 25 европейских языков — быстрое и точное распознавание без выбора движков и переключений. Качаешь один раз при первом запуске.
• IT-словарь — сотни терминов: «реакт» → React, «юзстейт» → useState, «гитхаб» → GitHub, «докер» → Docker.
• 100% офлайн — распознавание на CPU, голос никуда не уходит.

Пост-обработка

• Удаление филлеров — звуки-заминки («э-э», «ммм», «um») убираются автоматически; смысловые слова («ну», «вот») сохраняются.
• Числа цифрами — «пять серверов» → «5 серверов» (русский и английский).
• Пунктуация и заглавные буквы — Parakeet сам ставит точки, запятые и заглавные; между диктовками Vox автоматически добавляет пробел, чтобы фразы не склеивались.

Инструменты

• История диктовок — SQLite с полнотекстовым поиском (FTS5).
• Монитор коррекций — отслеживание и накопление исправлений для обучения.

---

🚀 Установка

1. Скачай установщик

Скачай vox-setup.exe (≈ 29 МБ) со страницы Releases и запусти его.

2. Пройди мастер установки

1. Жми Далее.
2. Галочки по желанию:
   • 🖥️ Создать ярлык на рабочем столе
   • ⚡ Запускать Vox при старте Windows (рекомендуем)
3. Жми Установить, подтверди UAC.
4. Оставь галочку «Запустить Vox» и жми Завершить.

3. Скачай модель (только при первом запуске)

Vox откроет окно «Первый запуск» и предложит скачать единственную модель распознавания:

Модель	Размер	Язык
Parakeet TDT v3	~670 МБ	25 европейских языков

Жми «Скачать и начать» → Vox скачает модель (30 сек — 2 мин) и сразу запустится. Выбирать ничего не нужно — Vox поставляется с одной моделью.

🇷🇺 Пользователям из России: модель лежит на GitHub Releases — если загрузка зависает, включи VPN.

4. Готово 🎉

В трее появится иконка Vox.

---

🎙 Использование

1. Кликни в любое поле ввода.
2. Зажми правый Ctrl — короткий «бип».
3. Говори спокойно, как обычно.
4. Отпусти Ctrl — текст в поле.

Автовставка не сработала? Текст в буфере обмена — нажми Ctrl+V.

---

💡 Примеры

Скажи	Получится
«Добавь юзстейт для счётчика»	Добавь useState для счётчика
«Запушь в гитхаб»	Запушь в GitHub
«Собери докер образ»	Собери Docker образ
«Закоммить и запушь в мейн»	Закоммить и запушь в main

---

🔧 Меню в трее

Правый клик на иконке Vox:

Пункт	Описание
Клавиша: …	Текущая горячая клавиша
Сменить клавишу ▸	Выбор: R/L Ctrl, R/L Shift, R/L Alt, Caps Lock, Scroll Lock, Pause, F1–F12
Модель: Parakeet TDT v3 ✓	Статус модели распознавания (✓ — загружена, ⏳ — нет); строка некликабельная
Модель распознавания ▸	Перекачать (ремонт) / Удалить модель распознавания
История…	Все диктовки с поиском
Открыть логи	Папка с логами
Открыть папку с моделями	Папка %APPDATA%\vox\models
Выход	Закрыть Vox

Горячая клавиша по умолчанию — правый Ctrl. Выбор сохраняется в config.json и применяется без перезапуска.

---

📁 Хранение данных

Путь	Содержимое
C:\Program Files\Vox\	Программа
%APPDATA%\vox\models\	Модели распознавания
%APPDATA%\vox\logs\	Логи
%APPDATA%\vox\vox_data.db	История, словарь, настройки

Быстрый доступ: Win+R → %APPDATA%\vox → Enter.

---

⚡ Автозапуск

Галочка в установщике — самый простой способ.

Если забыл:

1. Win+R → shell:startup → Enter.
2. Перетащи ярлык Vox.
3. ПКМ → Свойства → Дополнительно → Запуск от имени администратора.

---

🗑 Удаление

Параметры Windows → Приложения → Vox → Удалить.

Папки %APPDATA%\vox\models и %APPDATA%\vox\logs остаются — удали вручную, если не нужны.

---

❓ Решение проблем

Горячая клавиша не работает

Закрой Vox → запусти от имени администратора. Windows требует прав администратора для перехвата клавиш на системном уровне.

Vox не слышит голос

1. Проверь микрофон: Параметры Windows → Звук → уровень микрофона.
2. Говори громче и ближе к микрофону.
3. Логи: трей → Открыть логи.

Иконка в трее не появилась

Открой %APPDATA%\vox\logs\vox.log — там подробности ошибки.

Текст не вставляется автоматически

Некоторые приложения блокируют автовставку. Текст в буфере — нажми Ctrl+V.

SmartScreen предупреждает об установщике

Нажми «Подробнее» → «Выполнить в любом случае». Установщик пока не подписан сертификатом.

Модель не скачивается

Модель лежит на GitHub Releases и может быть недоступна из-за провайдера. Включи VPN и попробуй снова.

---

🛠 Для разработчиков

# Клонировать и запустить из исходников (нужен uv: https://docs.astral.sh/uv/)
git clone https://github.com/privatekey7/vox.git
cd vox
uv sync
uv run python vox.py

Сборка vox-setup.exe: build.bat (PyInstaller + Inno Setup 6).

---

💬 Связь

Новости, обновления, вопросы и предложения — в Telegram: @privatekey_ai.