cjpais / Handy

本文为原文前 6,000 字符的节选翻译，完整内容请查看原文。

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.

Handy 是一款免费、开源且可扩展的语音转文字应用程序，可完全离线运行。Handy 是一款跨平台桌面应用，提供简单且注重隐私的语音转录功能。按下快捷键，说话，你的文字就会出现在任何文本框中。这一切都在你自己的电脑上完成，不会向云端发送任何信息。

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.

为什么选择 Handy？Handy 的创建旨在填补真正开源、可扩展的语音转文字工具的空白。正如 handy.computer 所述：免费：辅助功能工具应属于每个人，而不是被付费墙阻挡。开源：我们可以共同进一步构建。你可以自行扩展 Handy 并为更宏大的目标做出贡献。隐私：你的声音保留在你的电脑上。无需将音频发送到云端即可获得转录。简单：一个工具，一项工作。转录你所说的话并将其放入文本框中。

How It Works: 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). Speak your words while the shortcut is active. Release and Handy processes your speech using Whisper. 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.

工作原理：按下可配置的键盘快捷键：按住以录音，松开以停止，或者点击以切换录音开关（也提供“仅按住”和“仅切换”模式）。在快捷键激活时说话。松开后，Handy 会使用 Whisper 处理你的语音。转录后的文本会直接粘贴到你正在使用的任何应用程序中。整个过程完全本地化：使用 Silero 进行 VAD（语音活动检测）以过滤静音。转录使用你选择的模型：Whisper 模型（Small/Medium/Turbo/Large，在可用时支持 GPU 加速）；Parakeet V3 - 针对 CPU 优化的模型，具有出色的性能和自动语言检测功能。适用于 Windows、macOS 和 Linux。

Quick Start Installation: 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: 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. Install the application. Launch Handy and grant necessary system permissions (microphone, accessibility). Configure your preferred keyboard shortcuts in Settings. Start transcribing!

快速安装指南：从发布页面或网站下载最新版本。macOS：也可通过 Homebrew cask 安装：brew install —cask handy。Windows：也可通过 winget 安装：winget install cjpais.Handy。注意：Homebrew cask 和 winget 软件包不由 Handy 开发人员维护。Debian/Ubuntu：使用 APT 安装下载的 .deb 文件，以便自动安装所需的依赖项：sudo apt install ./Handy_*.deb。除非已安装依赖项，否则请勿使用 dpkg -i。如果已经使用过，请运行 sudo apt —fix-broken install。安装应用程序。启动 Handy 并授予必要的系统权限（麦克风、辅助功能）。在设置中配置你偏好的键盘快捷键。开始转录！