localvoxtral — плагин
Локальная диктовка для macOS с плагинами Claude Code и Codex: голос превращается в текст промпта и понимает файлы.
- 65 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Приложению нужны разрешения macOS на микрофон и ввод в другие программы.
- Плагины передают приложению названия файлов, проектов и последний ход сессии, а скрипт установки выполняется по схеме curl | bash.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/T0mSIlver/localvoxtral/main/scripts/install.sh | bashПервый вариант из README: скрипт скачивается и выполняется сразу, прочитайте его заранее. Есть и `brew install --cask T0mSIlver/localvoxtral/localvoxtral`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Приложению нужны разрешения macOS на микрофон и ввод в другие программы.
- Плагины передают приложению названия файлов, проектов и последний ход сессии, а скрипт установки выполняется по схеме curl | bash.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
localvoxtral — приложение для строки меню macOS, которое превращает речь в текст в реальном времени и целиком на вашем Mac. По умолчанию работает открытая модель Voxtral Mini 4B Realtime от Mistral AI, на машинах с меньшей памятью можно взять Nemotron от NVIDIA. Учетной записи, подписки и телеметрии нет. Проект создан в первую очередь для промптов к агентам. Плагины для Claude Code и Codex сообщают приложению, чем занята сессия, и диктовка точнее узнает названия файлов, символы и тему последнего хода. Плагин для удаленного хоста передает такой контекст по туннелю SSH. Мод для Claude Code вставляет надиктованный текст в поле промпта и показывает диктовку над ним. Когда агент ждет ответа, приложение показывает баннер, подает звук и отмечает значок в строке меню.
Для кого. Разработчикам на Mac с Apple Silicon, которые ставят задачи Claude Code или Codex голосом и не хотят отправлять запись в облако.
Подходит, если
- Длинный промпт к агенту быстрее надиктовать, чем набрать.
- Диктовка путает имена файлов и функций, и ей нужен контекст сессии.
- Claude Code запущен на удаленном сервере по SSH, а диктовать удобно на Mac.
- Запись голоса не должна покидать компьютер: распознавание идет на устройстве.
- Агент ждет вашего решения в другом окне, и об этом должен сообщить звук.
Не подходит, если
- Mac на процессоре Intel или macOS старше 15: нужен Apple Silicon и macOS 15 или новее.
- Нужна диктовка на Windows или Linux: приложение только для macOS.
- Нельзя скачать 6 ГБ: при первой настройке локальный движок загружает около 6 ГБ.
Пример запроса к агенту
Включить диктовку клавишей Fn и продиктовать: «Открой файл settings.py и добавь параметр таймаута»Ограничения
Нужны Mac с Apple Silicon и macOS 15 или новее. При первой настройке мастер запрашивает разрешения и скачивает около 6 ГБ с моделями, лучше всего движок работает при 16 ГБ памяти, а на Mac с 8 ГБ отключают доработку текста или берут малые модели. Плагины Claude Code объявляют только хуки, а мод вставки текста работает лишь на сборке Claude Code, которая загружает модули хуков, иначе он ничего не делает. Необязательная функция запроса терминов проекта запускает отдельный разовый запуск Claude Code, это стоит примерно от 3 до 12 центов за проект. Хостовые модели Mistral и свои серверы допустимы, но тогда звук уходит за пределы Mac.
Как отключить. В настройках приложения отключите плагин Claude Code или выполните `claude plugin uninstall localvoxtral@localvoxtral`. Приложение удаляют как обычную программу macOS.
Частые вопросы
Как установить localvoxtral?
Одной командой: `curl -fsSL https://raw.githubusercontent.com/T0mSIlver/localvoxtral/main/scripts/install.sh | bash`, либо через Homebrew `brew install --cask T0mSIlver/localvoxtral/localvoxtral`, либо скачайте DMG из релизов. На первом запуске мастер скачивает движок.
Как подключить плагин к Claude Code?
В приложении откройте Settings, раздел Claude Code, Plugin и нажмите Install. Вручную команды такие: `claude plugin marketplace add` с путем к каталогу и `claude plugin install localvoxtral@localvoxtral`. Плагин объявляет только хуки и токенов не тратит.
Что уходит за пределы компьютера?
По умолчанию ничего: распознавание идет локально, без учетной записи и телеметрии. Звук уходит наружу только тогда, когда вы сами подключили Mistral или свой сервер.
С какими агентами работает диктовка?
С Claude Code, Codex, opencode и Mistral Vibe. Для Claude Code и Codex есть плагины, которые передают контекст сессии, а для удаленных хостов есть отдельный плагин через туннель SSH.
Какие модели распознавания используются?
По умолчанию Voxtral Mini 4B Realtime от Mistral AI. На Mac с меньшей памятью можно выбрать Nemotron 3.5 ASR Streaming или Nemotron Unified ASR от NVIDIA.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныЛокальный голосовой слой для Claude Code и Codex на macOS: когда агент закончил работу или упал, коротко говорит, что случилось
Заметки о встречах на Mac и MCP для агента: транскрипты в Markdown, поиск, итоги и задачи по записям, а бот на звонок не заходит
Плагин связывает Superwhisper и Claude Code: когда агент закончил или ждет ответа, окно открывается для голосовой реплики.
Голосовая надстройка поверх Claude Code, Codex и OpenCode: агент говорит и слушает, пока фоновые задачи выполняются параллельно
Навык ведет агента от идеи до рабочего TypeScript-расширения для Voz: диктовка на Mac становится командой, стилем или заметкой.
Приложение с заметками о звонках без бота: транскрипты и поиск по ним доступны Claude Code и Codex только на чтение через MCP
Коротко о README
Слоган проекта: говорите с кодинг-агентами и держите каждое слово на своем Mac. Текст появляется по мере речи, а не после ее конца.