matthartman/ghost-pepper

⭐ 1,894 Stars 🍴 91 Forks Swift

Ghost Pepper 是一个在 macOS 上运行的本地化语音识别应用,通过按住控制键说话,释放后进行转录并粘贴到任何文本字段。

来源:据 README 描述 查看 GitHub 仓库 →

为什么值得关注

Ghost Pepper 受关注的原因包括其本地化处理、隐私保护(无数据上传云端)以及简洁易用的界面。它填补了市场上对本地化语音识别工具的需求空白,并采用了 WhisperKit 和 LLM.swift 等技术,提供了独特的语音识别和文本清理功能。

来源:综合 README 描述和项目特征

核心功能

本地化语音识别

通过按住控制键说话,释放后进行转录,支持多种语言模型,包括 Whisper tiny.en、Whisper small.en 和 Parakeet v3。

来源:据 README 描述
本地化文本清理

使用本地 LLM 清理模型去除填充词和自我纠正,支持多种清理模型,如 Qwen 3.5 0.8B、Qwen 3.5 2B 和 Qwen 3.5 4B。

来源:据 README 描述
菜单栏应用

作为菜单栏应用存在,无需 dock 图标,可在登录时自动启动。

来源:据 README 描述
自定义设置

允许用户编辑清理提示、选择麦克风和切换功能。

来源:据 README 描述

技术架构

项目采用模块化设计,代码目录结构清晰,包括 CleanupModelProbe、CleanupModelProbeSupport 和 GhostPepper 等模块。数据流从用户语音输入到语音模型处理,再到本地 LLM 清理,最后输出到文本字段。关键的技术决策包括本地化处理和隐私保护。

来源:代码目录结构

技术栈

infra: 本地运行,无特定基础设施要求  |  key_deps: WhisperKit, LLM.swift, Hugging Face  |  language: Swift  |  framework: Xcode

来源:代码目录结构 + 依赖文件

快速上手

1. 下载 [GhostPepper.dmg](https://github.com/matthartman/ghost-pepper/releases/latest/download/GhostPepper.dmg) 2. 打开 DMG,将 Ghost Pepper 拖到 Applications 3. 根据提示授予麦克风和访问权限 4. 按住控制键并说话
来源:README Installation/Quick Start

使用场景

1. 需要在 macOS 上进行本地化语音转文本的用户 2. 关注隐私保护,不希望数据上传到云的用户 3. 需要在没有互联网连接的环境下使用语音识别的用户 4. 开发者需要集成语音识别功能到自己的 macOS 应用中

优势与局限

优势

  • 本地化处理,保护用户隐私
  • 功能全面,支持多种语言和清理模型
  • 界面简洁易用

局限

  • 目前仅支持 macOS 平台
  • 依赖外部模型,可能受模型更新影响
来源:综合 README、代码结构和依赖分析

最新版本

v2.0.1 (2026-04-06): 修复麦克风权限提示未出现的问题 v2.0.0 (2026-04-06): 引入 Pepper Chat 功能,一个实验性的 AI 对话功能

总结评价

Ghost Pepper 是一个值得关注的开源项目,特别是对于需要本地化语音识别和隐私保护的 macOS 用户。它适合寻求高效、安全语音转文本解决方案的个人和团队使用。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间:2026-04-07 18:31。质量评分:75/100。 所有结论均标注了数据来源。如发现不准确之处,欢迎反馈。

数据来源: README、GitHub API、依赖文件