typewhisper-mac

在 Mac 上离线语音秒变文字，隐私无忧

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署语音识别 🍴 复刻 154 🐛 待处理 67 👀 关注 5

GitHub ↗

GitHub 星标 ★ 1912

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，本地部署，完全免费，无付费版本。

项目预览

typewhisper-mac 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类语音识别

开发团队TypeWhisper

GitHubhttps://github.com/TypeWhisper/typewhisper-mac

定价模式🏷️完全免费

价格说明开源项目，本地部署，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议GPL-3.0

主要语言Swift

技术栈/模型apple-silicon,dictation,macos,on-device,privacy,speech-to-text,swiftui,transcription,whisper,whisperkit

GitHub 星标★ 1912

上线时间2026-02-12 00:00:00

代码更新2026-11-08

仓库体积200.7 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-10

浏览次数12

项目介绍

typewhisper-mac 是一款专为 macOS 设计的本地语音转文字工具，基于 Apple Silicon 芯片和 WhisperKit 框架，实现完全离线的设备端 AI 转录，同时支持可选的云端服务。它解决的是用户在 Mac 上快速、私密地将语音转换为文字的需求，尤其适合注重隐私的场景。核心能力包括：利用 Apple 神经网络引擎进行高效本地推理，支持多种 Whisper 模型，提供 SwiftUI 原生界面，可实现全局快捷键唤起、实时转录、字幕生成等功能。与系统自带听写相比，它更灵活、准确，且完全离线运行，不依赖网络，确保数据不出设备。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 1912

技术标签

apple-silicon dictation macos on-device privacy

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

macOS 系统（本地模型依赖 Apple Silicon 芯片与 WhisperKit 框架）
麦克风权限（用于录制语音）
辅助功能（Accessibility）权限（用于全局快捷键与文本注入）
可选：Groq / OpenAI / xAI(Grok) 云端 API 密钥（仅在需要云端转录时使用）

安装与启动步骤

1安装 TypeWhisper

README 提供两种方式：Homebrew（cask 名为 typewhisper）或下载最新 DMG 安装包。安装后从启动台打开应用。
```
brew install --cask typewhisper
```
2授予系统权限

打开 Settings，为 TypeWhisper 开启麦克风权限和辅助功能（Accessibility）权限，否则无法录音或把文字输入到其他应用。
3选择转录引擎

在 Settings 中选择引擎：本地模型走设备端离线推理，或填入 Groq / OpenAI / xAI 等云端 API 密钥获得更快处理。
4下载本地模型

若使用本地转录，需先在 Settings 中下载一个 Whisper 模型；模型下载完成后即可完全离线运行，数据不出设备。
5完成首次听写

按下全局快捷键唤起听写，对着麦克风说话，转录结果会实时输出到当前光标位置，可再套用工作流做文本处理。
6（可选）安装 CLI

如需命令行工具，进入 Settings > Advanced > CLI Tool > Install，会把 typewhisper 二进制安装到 /usr/local/bin。

关键配置

配置项	必填	说明	示例
`云端 API Key`	否	可选，填入 Groq / OpenAI / xAI 密钥后启用云端转录	`sk-xxxxxxxxxxxxxxxx`
`本地 Whisper 模型`	否	本地离线转录所用模型，需在设置内下载后才能使用	`whisper-large-v3`
`全局快捷键`	是	唤起听写的系统级热键，需先授予辅助功能权限	`⌥ + Space`

如何确认成功

按下全局快捷键说话，文字能实时出现在当前光标处或 Recorder 中，即表示听写已正常工作。

常见问题

Q：可以完全不联网使用吗？

A：可以。选择本地模型后转录在设备端完成，语音数据不会离开 Mac；只有主动配置并使用 Groq、OpenAI、xAI 等云端 API 时才需要联网。

Q：如何彻底卸载？

A：先 brew uninstall --cask typewhisper，再删除 /Applications/TypeWhisper.app、~/Library/Application Support/TypeWhisper、偏好文件与 Group Containers，并在钥匙串中删除 com.typewhisper.mac.apikey 相关条目。

Q：没有 Apple Silicon 芯片能用吗？

A：本地模型依赖 Apple Silicon 的神经网络引擎与 WhisperKit 框架；非 Apple Silicon 设备建议改用云端 API 引擎。

Q：卸载后重装仍立刻崩溃怎么办？

A：按 README 的手动卸载步骤清干净所有残留（含钥匙串与 Group Containers），重启 Mac 后再装最新版本；若仍崩溃请提 Issue 并附 macOS 版本与安装方式。