English

Voice Key

一款开源的桌面语音输入应用

查看演示 · 报告 Bug · 请求功能

• 语音转写: 集成 GLM ASR，实现高精度语音转文字。
• 文本润色: 支持基于 OpenAI-compatible 接口的轻量后处理。
• 文本注入: 转写完成后可直接注入到当前焦点输入框。
• 桌面工作流: 提供全局快捷键、HUD、日志和更新检查能力。

(back to top)

按照以下步骤在本地启动项目。

• Node.js
• npm

npm install npm@latest -g

1. 获取免费 API Key（见配置要求）。
2. 克隆仓库。

git clone https://github.com/BuildWithAIs/voicekey.git

3. 安装依赖。

npm install

4. 启动开发环境。

npm run dev

5. 在设置页中填写 API Key。

(back to top)

本应用依赖 智谱 AI (GLM) 的语音转写服务，使用前需要先配置 API Key。

1. 获取 API Key: 访问智谱 AI 开放平台 中国站 或 国际站 注册并获取 Key。
2. 完成配置: 打开 Voice Key 设置页，填入你的 API Key。

由于应用当前未签名，安装后可能需要额外执行以下步骤。

1. 解除安全限制

   如果打开应用时提示“文件已损坏”，请在终端运行：

   xattr -cr /Applications/Voice\ Key.app

   

2. 授予辅助功能权限

   应用需要监听按键并模拟输入。请前往 系统设置 > 隐私与安全性 > 辅助功能，为 Voice Key 打开权限。

   

本项目采用 Elastic License 2.0。

(back to top)