typewhisper-mac

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

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

开源 free 语音识别
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1800
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类语音识别
开发团队TypeWhisper
所属国家
官网地址
定价模式free
价格说明开源项目,本地部署,完全免费,无付费版本。
访问状态
是否开源是
开源协议GPL-3.0
主要语言Swift
技术栈/模型apple-silicon,dictation,macos,on-device,privacy,speech-to-text,swiftui,transcription,whisper,whisperkit
GitHub 星标★ 1800
30天Star增速
HF 下载量
上线时间2026-02-12 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-10
浏览次数8

使用教程

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

环境要求

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

安装与启动步骤

  1. 1安装 TypeWhisper

    README 提供两种方式:Homebrew(cask 名为 typewhisper)或下载最新 DMG 安装包。安装后从启动台打开应用。

    brew install --cask typewhisper
  2. 2授予系统权限

    打开 Settings,为 TypeWhisper 开启麦克风权限和辅助功能(Accessibility)权限,否则无法录音或把文字输入到其他应用。

  3. 3选择转录引擎

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

  4. 4下载本地模型

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

  5. 5完成首次听写

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

  6. 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 版本与安装方式。

注意事项

  • README 的 Install 小节为空,安装命令由卸载章节中的 cask 名 typewhisper 推断,建议同时参考官方 DMG 方式
  • 首次启动必须授权麦克风与辅助功能,否则快捷键和文字注入不可用
  • 本地模型文件较大,下载需要预留磁盘空间与时间
  • 1.6 为当前稳定版,卸载或重装前请确认版本以匹配README 路径

核心亮点

  • 完全离线运行,音频数据不出设备,隐私保护强
  • 针对 Apple Silicon 优化,转录速度快、功耗低
  • SwiftUI 原生界面,操作流畅,支持全局快捷键

不足之处

  • 仅支持 Apple Silicon Mac,Intel 机型无法使用
  • 文档/社区待观察

适用场景

  • 需要快速记录灵感、会议纪要的隐私敏感场景
  • 无网络或弱网环境下的语音输入
  • 视频字幕、播客转写等本地批量处理

替代项目

Whisper Transcription、MacWhisper、Superwhisper

项目介绍

typewhisper-mac 是语音识别领域的开源项目,由 TypeWhisper 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,800)位列前 30%,在语音识别分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,687 增加到 1,800,净增 113。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。本地部署,完全免费,无付费版本。

它主要面向的使用场景是:需要快速记录灵感、会议纪要的隐私敏感场景。同类可对比的替代方案包括 Whisper Transcription、MacWhisper、Superwhisper。

上一篇:OpenSuperWhisper

下一篇:Handy

同类项目推荐

obs-localvocal 开源

直播录屏时,本地AI实时生成字幕,保护隐私零延迟

OBS plugin for local speech recognition and captioning using AI

★ 1616 2026-09-10
LiveCaptions-Translator 开源

实时捕获系统音频,一键翻译成你懂的语言

Lightweight and powerful real-time audio/speech translation tool based on Windows Li···

★ 3755 2026-08-10
speechbrain 开源

一站式 PyTorch 语音工具箱,快速搞定识别、说话人验证等任务

A PyTorch-based Speech Toolkit

★ 11834 2026-08-26
whisper-diarization 开源

给语音转写加上说话人标签,会议记录一目了然

Automatic Speech Recognition with Speaker Diarization based on OpenAI Whisper

★ 5657 2026-08-13