项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11458
技术标签
使用教程
环境要求
- 已安装 Python 与 pip（通过 pip 安装 moonshine-voice 包）
- 可用的麦克风等音频输入设备（mic 命令用于实时采集语音）
- 无需账号或 API 密钥，全部在设备本地运行
安装与启动步骤
-
1安装 Moonshine
用 pip 安装官方发布的 moonshine-voice 包，安装完成后即可使用同名命令行工具。
pip install moonshine-voice -
2启动麦克风转写
运行 mic 子命令并从麦克风拾音，用 --language 指定识别语言，如 en 表示英语。
moonshine-voice mic --language en -
3可选：接入编码代理
如果用编码代理写代码，可添加官方 skill，让代理了解当前 API 用法，避免误用旧接口。
npx skills add moonshine-ai/moonshine --skill moonshine-voice
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--language | 否 | 指定语音识别使用的语言代码 | en |
如何确认成功
命令行未报错并进入麦克风监听状态、终端出现实时转写结果，即表示安装与启动成功。
常见问题
Q：安装后提示找不到 moonshine-voice 命令怎么办？
A：确认 pip 对应的 Python 环境与当前终端一致，可先用 pip show moonshine-voice 检查是否装成功，再重新执行 pip install moonshine-voice。
Q：运行时没有识别结果或提示音频相关错误？
A：mic 命令需要麦克风输入，请确认系统已连接麦克风、终端有录音权限，且没有被其他程序独占。
Q：需要申请 API Key 或联网上传音频吗？
A：不需要。README 说明全部在设备本地运行，速度快、隐私性好，无需账号或 API 密钥。
Q：Python 之外的平台怎么用？
A：官方 Quickstart 覆盖 Python、JavaScript/WASM、iOS、Android、macOS、Linux、Windows 和树莓派，详见 moonshine-voice.readthedocs.io。
注意事项
- 所有推理都在设备本地完成，无需账号或 API 密钥。
- 其他平台安装方式与可运行示例见官方文档 moonshine-voice.readthedocs.io 的 Quickstart 与 Examples。
- 使用编码代理时也可手动把 .agents/skills/moonshine-voice/ 复制到项目的 .agents/skills/ 目录。
核心亮点
- 端到端延迟极低，实测语音转写响应速度优于主流方案，适合实时对话
- 一体化集成 STT、意图识别、TTS，免去多组件拼装和调优成本
- C++ 实现，内存占用小，支持边缘设备部署，性能稳定
不足之处
- 文档相对简略，部分高级用法需自行阅读源码
- 模型生态较新，预训练模型覆盖语种有限，中文支持待加强
适用场景
- 构建实时语音助手（如智能音箱、车载语音）
- 开发低延迟语音客服机器人，提升交互流畅度
- 用于语音控制界面（如无障碍辅助、工业语音指令）
替代项目
Whisper.cpp、Vosk、Coqui TTS
下一篇：PaddleSpeech
同类项目推荐
nodejs-whisper
开源
在 Node.js 里本地跑 Whisper，音频转文字不用 Python
NodeJS Bindings for Whisper - the CPU version of OpenAI's Whisper, as initially craf···
Audio8-ASR-Infinite
开源
几小时录音丢进去，一口气转成文字
ha-openai-whisper-stt-api
开源
把语音识别甩给云端，低配 Home Assistant 也能秒回话
HACS custom integration for using Whisper speech-to-text (OpenAI, GroqCloud or Mistr···
tiny-audio
开源
25 美元训出带时间戳和说话人分离的语音转文字
A speech-to-text system you can train for $25. A frozen speech encoder and a Qwen LL···
web-speech-cognitive-services
开源
用Azure服务补齐浏览器语音API，统一标准接入
Polyfill Web Speech API with Cognitive Services for both speech-to-text and text-to-···
leopard
开源
本地离线把语音转成文字，不联网也能用
On-device speech-to-text engine powered by deep learning
obs-localvocal
开源
直播录屏时，本地AI实时生成字幕，保护隐私零延迟
OBS plugin for local speech recognition and captioning using AI
go-whisper
开源
用 Go 直接跑 Whisper，把音频转成文字
Speech-to-Text in golang
moonshine
开源
超低延迟语音全家桶，让语音交互快人一步
Very low latency speech to text, intent recognition, and text to speech, for buildin···