About This Project
Overview
Voice Agent lets you dictate anywhere on Linux: hold F8, speak, release, and the audio is transcribed locally by Faster-Whisper — no cloud round-trip for speech recognition. An optional Groq-powered formatting pass cleans up grammar and converts spoken commands like 'heading one' or 'bullet point' into markdown before the text lands on the clipboard, ready to paste into any app on X11 or Wayland.
Motivation
I wanted to dictate anywhere on Linux without sending my voice to a cloud service, so I built a hotkey-driven tool around Faster-Whisper that keeps transcription entirely local.
Lessons Learned
Getting a global hotkey to behave consistently across X11 and Wayland took far more trial and error than the actual transcription pipeline — desktop environment fragmentation on Linux is very real.