cjpais /Handy
A free, open source, and extensible speech-to-text application that works completely offline.
★ 38,863⑂ 3,676👁 101⑃ 1,020● 859▤ 68
+105
日增长
+760
周增长
38,863
stars
3,676
forks
101
watchers
1,020
prs
859
issues
68
releases
README
Handy
A free, open source, and extensible speech-to-text application that works completely offline.
Handy is a cross-platform desktop application that provides simple, privacy-focused speech transcription. Press a shortcut, speak, and have your words appear in any text field. This happens on your own computer without sending any information to the cloud.
Why Handy?
Handy was created to fill the gap for a truly open source, extensible speech-to-text tool. As stated on handy.computer:
- Free: Accessibility tooling belongs in everyone's hands, not behind a paywall
- Open Source: Together we can build further. Extend Handy for yourself and contribute to something bigger
- Private: Your voice stays on your computer. Get transcriptions without sending audio to the cloud
- Simple: One tool, one job. Transcribe what you say and put it into a text box
How It Works
1. Press a configurable keyboard shortcut: hold it to record and release to stop, or tap it to toggle recording on and off (Hold-only and Toggle-only modes are also available)
2. Speak your words while the shortcut is active
3. Release and Handy processes your speech using Whisper
4. Get your transcribed text pasted directly into whatever app you're using
The process is entirely local:
- Silence is filtered using VAD (Voice Activity Detection) with Silero
- Transcription uses your choice of models:
- Whisper models (Small/Medium/Turbo/Large) with GPU acceleration when available
- Parakeet V3 - CPU-optimized model with excellent performance and automatic language detection
- Works on Windows, macOS, and Linux
Quick Start
Installation
1. Download the latest release from the releases page or the website
- macOS: Also available via Homebrew cask: brew install --cask handy
- Windows: Also available via winget: winget install cjpais.Handy \
Note: The Homebrew cask and winget package are not maintained by the Handy developers.
- Debian/Ubuntu: Install the downloaded .deb with APT so required dependencies are installed automatically:
bash
sudo apt install ./Handy_.deb
Do not use dpkg -i unless the dependencies are already installed. If you already used it, run sudo apt --fix-broken install.
2. Install the application
3. Launch Handy and grant necessary system permissions (microphone, accessibility)
4. Configure your preferred keyboard shortcuts in Settings
5. Start transcribing!
Development Setup
For detailed build instructions including platform-specific requirements, see BUILD.md.
Sponsors
We're grateful for the support of our sponsors who help make Handy possible:
Integrations
Control Handy from Raycast — start/stop recording, browse transcript history, manage dictionary, switch models and languages.
Source · by @mattiacolombomc
Debug Mode
Handy includes an advanceTop issues
#502[BUG] Pastes clipboard instead of spoken text93 comments · 2025-12-30#102[BUG] Keyboard Shortcut not working Ubuntu 22.0445 comments · 2025-09-04#1101[BUG] audio recording issue. Microphone initialize twice15 comments · 2026-03-19#844[BUG] Can't use Super as a hotkey modifier on Ubuntu11 comments · 2026-02-17#1428Would it be possible to list Handy in the Windows Store?10 comments · 2026-05-23#642[BUG] muting the system audio has delay during recording10 comments · 2026-01-21#1281[BUG] System-wide freeze when Accessibility permissions are revoked while app is running9 comments · 2026-04-12#1005[BUG] Handy's process stays open in the background.9 comments · 2026-03-11
Discussions
#2517How to cite Handy?1 comments · 2026-11-15#2516How to cite Handy?0 comments · 2026-11-15#2515Support OBS Studio MKV recordings in file transcription0 comments · 2026-11-15#2511hide Dock icon0 comments · 2026-11-14#2509Add background prompt settings to support contextual local ASR models0 comments · 2026-11-14#2507Pluggable speech-to-text endpoint for restricted / air-gapped networks2 comments · 2026-11-14#2497Trojan.Win32.Evasion0 comments · 2026-11-13#2494Add colour options for tool tray icon0 comments · 2026-11-13
Latest release
v0.10.1 v0.10.1 2026-11-14a ton of bug fixes! thanks all for the contributions What's Changed fix(deps): address TLS dependency security advisories (CVE-2026-41677) by @JesseDyer in https://github.com/cjpais/Handy/pull/2432 fix(overlay): disable WebView2 context menu on the recording overlay by @alanshurafa in https://github.com/cjpais/Handy/pull/2403 fix: build the async runtime before streaming logs to the webview by @alanshurafa in https://github.com/cjpais/Handy/pull/2478 Let AppImage users opt into native Wayland by @alanshurafa in https://github.com/cjpais/Handy/pull/2453 fix: turn off the updater o
相关报道 (2)
News & coverage (6)
Hacker NewsHandy – Free open source speech-to-text app▲ 247 · 110 comments · 2026-01-15InfoWorldGitHub Desktop 3: Handy, but still limited2015-08-13The GitHub BlogGitHub Desktop 3.6: Worktrees and deeper Copilot integration2026-06-26BGR11 Free And Open-Source Apps Every Mac User Needs To Try2026-05-07It's FOSSStop Manually Checking GitHub Releases — These Tools Automatically Install & Update Apps on Linux2025-12-23TechRepublicHow to add a GitHub repository to VS Code2022-09-05