localvoxtral-remote

<h1 align="center">localvoxtral</h1> <p align="center"> <img src="assets/icons/app/AppIcon.png" alt="localvoxtral app icon" width="128" height="128" /> </p> <p align="center"> <strong>Talk to your coding agents. Keep every word on your Mac.</strong><br /> Realtime, fully local dictation for the menu bar. Press a key and speak. Your words appear while you're still talking. </p> <p align="center"> <a href="#install">Install</a> · <a href="https://t0msilver.github.io/localvoxtral/docs/">Documentation</a> · <a href="https://t0msilver.github.io/localvoxtral/docs/coding-agents/">Coding agents</a> · <a href="CONTRIBUTING.md">Contributing</a> </p> <p align="center"> <a href="https://github.com/T0mSIlver/localvoxtral/stargazers"><img src="https://img.shields.io/github/stars/T0mSIlver/localvoxtral?style=social" alt="GitHub stars" /></a> &nbsp; <a href="https://github.com/T0mSIlver/localvoxtral/releases/latest"><img src="https://img.shields.io/github/v/release/T0mSIlver/localvoxtral?label=release" alt="Latest release" /></a> &nbsp; <a href="LICENSE"><img src="https://img.shields.io/github/license/T0mSIlver/localvoxtral" alt="License" /></a> </p>

https://github.com/user-attachments/assets/81a341ff-0c53-4fcf-9b7f-ef148b24dfae

localvoxtral streams text as the audio arrives instead of transcribing after you stop speaking. It runs Mistral AI's Voxtral Mini 4B Realtime on your own Apple Silicon.

It is built first for prompting coding agents by voice, and it works as a general dictation app in any other app too. Everything runs on-device, with no account and no subscription. Nothing leaves your Mac unless you point it at a server yourself.

Install

curl -fsSL https://raw.githubusercontent.com/T0mSIlver/localvoxtral/main/scripts/install.sh | bash

Or install with Homebrew:

brew install --cask T0mSIlver/localvoxtral/localvoxtral

You can also download the latest DMG from Releases. localvoxtral needs an Apple Silicon Mac on macOS 15 or later.

On first launch, a setup wizard asks for permissions and downloads the engine.

Features

• Jump to the agent that needs you. When one of your coding agents waits for an answer, localvoxtral tells you. Press Tab while you dictate, and that agent's pane comes to the front so you can read its question while you answer. Your words go there (details).
• Built for coding agents. Dictate prompts straight into any CLI agent (opencode, Mistral Vibe and Codex get their own integrations), in any terminal: Warp, WezTerm, kitty, Alacritty, and more. Polishing understands developer speech: "dash dash force" becomes --force, "use auth dot t s" becomes useAuth.ts (details).
• Claude Code aware. Dictation joins the exact session under your cursor: Ghostty, iTerm2, Terminal.app, a single herdr or cmux pane, over SSH, or a claude.ai/code Remote Control tab in your browser. Polishing is grounded in that session's screen, your last prompt, the files Claude just touched, and the repo's vocabulary (details).
• One key. Tap or hold to dictate into an overlay you can review, with optional LLM polishing. Press Tab to save the words to your Inbox instead (shortcuts).
• Private. Audio capture, transcription and polishing run on your Mac. No telemetry, no account, no cloud fallback (how it works).
• Menu bar native. The popover shows dictation status and a microphone picker. The app can copy the final text for you, and after a polished commit the raw transcript is one click away.
• Bring your own server. Dictation and polishing can each point at any OpenAI-compatible endpoint, or at Mistral's hosted API with one key, instead of the built-in local engines (details).
• Multilingual. Dictate in English, French, or any language Voxtral understands. Polishing answers in the language you spoke (English and French are covered by the test suite).

[!TIP] If localvoxtral is useful to you, a ⭐ on this repo helps others find it.

Documentation

Every guide is listed in the documentation index.

License

MIT