What VoxFlow Is

VoxFlow stays in the app you are already using. It is not a voice assistant: it does not take over your window, move you into another input box, press Enter, or submit messages for you.

It is a voice keyboard first, with a local workbench around the things you capture while working: dictation, screenshots, screen recordings, clipboard items, notes, and local coding-agent instructions.

Core Workflows

Who It Is For

• People who write, code, debug, and explain things faster by speaking than typing.
• Users who switch between ChatGPT, Claude, Codex, Cursor, terminal agents, notes, screenshots, and browser research.
• Developers who need accurate mixed Chinese-English technical dictation.
• Anyone who wants screenshots, recordings, clipboard items, and dictated text to become reusable local context.

Highlights

• Global dictation: Hold to speak and release to insert text in any editable field.
• Local asset workbench: Dictation, screenshots, screen recordings, clipboard items, and notes become searchable assets.
• Multiple ASR providers: Apple Speech works out of the box; local and cloud providers are available when configured.
• Personal corrections: Local deterministic rules and optional conservative LLM correction help stabilize names, terms, and technical words.
• Screenshot and clipboard OCR: Extract text from screenshots, copied images, web pages, error dialogs, and design mockups.
• Ask AI and Quicklinks: The launcher can ask your configured LLM provider or search Google, GitHub, StackOverflow, YouTube, Bilibili, Taobao, JD, and more.
• AI Coding Assistant workflows: Compose prompts or dispatch spoken instructions to local coding-agent sessions.
• Local-first privacy: History and assets stay on your Mac by default; cloud ASR and LLM calls are opt-in.

Quick Start

Download And Install

Download the latest release from GitHub Releases:

Requirements

• macOS 15+, Windows x64, or iOS 17+
• A microphone
• iOS IPA installation requires a device registered for this Ad Hoc release

First Permissions

If a shortcut does not respond after granting permissions, quit and reopen VoxFlow.

Default Shortcuts

How To Use

Dictation

1. Place your cursor in any text field.
2. Hold the dictation shortcut.
3. Speak while the overlay shows live recognition.
4. Release the shortcut. VoxFlow inserts the final text at the cursor.

Workbench

Open the Workbench to review local history, screenshots, recordings, notes, personal corrections, models, provider settings, and AI Coding Assistant sessions.

Screenshot And Clipboard OCR

Use ⌘⇧V for copied images and ⌘⇧A for a selected screen region. OCR text can be copied, spoken, translated, summarized, or reused later from the Workbench.

Agent Workflows

Task Assistant turns visible window context plus spoken intent into a prompt. AI Coding Assistant dispatches spoken instructions to registered local coding-agent sessions.

See Agent workflows for setup and safety boundaries.

Speech Models

VoxFlow supports Apple Speech out of the box, local providers such as Qwen3-ASR, Whisper, FunASR, SenseVoice, Paraformer, NVIDIA Nemotron, Parakeet, and Omnilingual, plus optional cloud providers such as Groq, Tencent Cloud, Alibaba Cloud, and future provider slots.

See Speech models for the full provider matrix.

Privacy Summary

• Dictation history, screenshots, recordings, clipboard assets, notes, personal corrections, and non-secret settings are stored locally by default.
• LLM API keys and cloud ASR credentials are stored in the local credentials file.
• Local ASR models keep audio on-device.
• Cloud ASR sends recorded audio to the selected provider.
• LLM correction and Ask AI send text only to the provider you configure.
• Diagnostics are local by default; crash or trace upload behavior is controlled by settings.

See Privacy and data and Privacy Policy for details.

Documentation

Build From Source

git clone https://github.com/xingbofeng/VoxFlow.git
cd VoxFlow
make run-dev

See Build from source for commands, source layout, and development notes.

Connect

Follow the author on X: @Counterxing

WeChat And User Group

Scan the QR codes below to add the author on WeChat or join the VoxFlow user group.