cjpais/Handy

这是什么？

核心功能

• 01语音识别完全在本机离线运行。
• 02通过可自定义的全局快捷键开始和停止录音。
• 03支持 Whisper 模型和 Parakeet V3 模型，也可加载自定义 Whisper GGML 模型。
• 04使用 Silero 语音活动检测过滤静音片段。
• 05支持 Windows、macOS 和 Linux，并提供命令行参数远程控制。

适用场景

• 在任意应用中口述消息、邮件或文档，无需把音频发送到云服务。
• 作为无障碍辅助工具，减少键盘输入。
• 工作时免手动输入，快速记录或起草内容。
• 通过命令行参数将语音输入接入 Wayland、Sway 或 Hyprland 工作流。

快速上手

1. 1

   从发布页面下载最新版本

2. 2

   在 macOS 上通过 Homebrew cask 安装

   brew install --cask handy
3. 3

   启动 Handy 并授予麦克风和辅助功能权限

4. 4

   在设置中配置键盘快捷键并开始转录

使用前须知

• !Linux 上的 Wayland 支持有限，需要 wtype 或 dotool 才能可靠地输入文本。
• !使用 fn（Globe）键的快捷键仅适用于 Apple 键盘。
• !Homebrew cask 和 winget 包并非由 Handy 开发者维护。

标签

常见问题

Handy 是什么？

一款免费开源、可完全离线运行的桌面语音转文字工具，可将语音直接输入到任意文本框中。 Handy 是一款跨平台桌面语音转文字应用。按下快捷键说话，识别出的文字会自动粘贴到当前获得焦点的应用中。音频完全在本机处理，不会上传到云端。

Handy 可以免费使用吗？用的什么许可证？

Handy 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Handy 还在维护吗？

活跃维护中。Handy 最近一次提交是在 2026年10月20日。

Handy 适合用来做什么？

在任意应用中口述消息、邮件或文档，无需把音频发送到云服务。 作为无障碍辅助工具，减少键盘输入。 工作时免手动输入，快速记录或起草内容。 通过命令行参数将语音输入接入 Wayland、Sway 或 Hyprland 工作流。

Handy 怎么安装和运行？

从发布页面下载最新版本 在 macOS 上通过 Homebrew cask 安装: brew install --cask handy 启动 Handy 并授予麦克风和辅助功能权限 在设置中配置键盘快捷键并开始转录

在哪里获取 Handy？

源代码和安装说明在 GitHub 上：https://github.com/cjpais/Handy