
PaddleSpeech
一站式语音工具箱,快速实现识别、合成与唤醒
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 12705
使用教程
环境要求
- 强烈推荐在 Linux 系统上安装
- Python >= 3.8
- 已安装 pip,且能访问百度镜像源(mirror.baidu.com)
- 测试音频需为 16k wav 格式
安装与启动步骤
-
1安装飞桨框架
先安装 PaddlePaddle 作为底层依赖。2.4.1 只是示例版本,请根据你选的 PaddleSpeech 版本所需的最小依赖调整版本号。
pip install paddlepaddle==2.4.1 -i https://mirror.baidu.com/pypi/simple -
2安装语音工具包
README 提供 pip 安装与源码编译两种方式,源码编译为官方推荐。这里用 pip 方式,先装 pytest-runner 再装 paddlespeech。
pip install pytest-runner pip install paddlespeech -
3下载测试音频
下载官方提供的示例音频用于后续推理测试,如需测试自己的音频可替换 --input 参数。
wget -c https://paddlespeech.cdn.bcebos.com/PaddleAudio/zh.wav wget -c https://paddlespeech.cdn.bcebos.com/PaddleAudio/en.wav -
4启动语音服务
在项目根目录用 demos 下的 application.yaml 启动语音服务端,默认监听 8090 端口,等待模型加载完成。
paddlespeech_server start --config_file ./demos/speech_server/conf/application.yaml -
5调用语音识别
另开终端调用 ASR 服务,把音频路径换成你自己的 16k wav 文件,服务端会返回识别文本。
paddlespeech_client asr --server_ip 127.0.0.1 --port 8090 --input input_16k.wav -
6调用语音合成
调用 TTS 服务,把文本合成语音并保存为 output.wav,可换成任意中英文文本。
paddlespeech_client tts --server_ip 127.0.0.1 --port 8090 --input "您好,欢迎使用百度飞桨语音合成服务。" --output output.wav -
7启动流式识别服务
使用流式 ASR 的配置文件启动服务端,适合实时交互场景,客户端需用 asr_online 命令调用。
paddlespeech_server start --config_file ./demos/streaming_asr_server/conf/application.yaml -
8调用流式识别
用 asr_online 调用流式服务;流式 TTS 需启动 tts_online_application.yaml 配置并访问 8092 端口。
paddlespeech_client asr_online --server_ip 127.0.0.1 --port 8090 --input input_16k.wav
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
config_file | 是 | 服务端配置文件路径,决定加载哪些模型与服务参数 | ./demos/speech_server/conf/application.yaml |
server_ip | 是 | 客户端连接的服务端 IP 地址 | 127.0.0.1 |
port | 是 | 服务端口,普通服务为 8090,流式 TTS 为 8092 | 8090 |
input | 是 | 输入内容,语音任务填 16k wav 音频路径,合成任务填文本 | input_16k.wav |
output | 否 | 语音合成输出音频文件路径 | output.wav |
protocol | 否 | 流式 TTS 服务使用的通信协议 | http |
如何确认成功
服务端启动无报错并持续运行;客户端能返回识别文本,或生成可播放的 output.wav 文件,即部署成功。
常见问题
Q:必须先装 PaddlePaddle 吗?
A:是的,README 要求先安装 paddlepaddle(示例版本 2.4.1),再执行 pip install pytest-runner 和 pip install paddlespeech。
Q:可以在 Windows 上安装吗?
A:README 强烈推荐 Linux,徽章显示支持 linux/win/mac,但未给出 Windows 的具体安装命令,建议优先使用 Linux。
Q:对输入音频有什么要求?
A:README 说明支持 16k wav 格式音频,可用 --input 换成自己的音频或文本进行测试。
Q:安装过程报错怎么办?
A:可查阅安装文档 ./docs/source/install.md,涵盖 conda 环境、librosa 依赖、gcc、kaldi 安装等问题,也可到 issue #2150 留言。
Q:不同服务的端口分别是多少?
A:普通 ASR/TTS/分类服务为 8090,流式 TTS 客户端示例使用 8092。
注意事项
- README 强烈推荐在 Linux 系统、Python >= 3.8 环境下安装。
- paddlepaddle==2.4.1 仅为示例,需按所选 PaddleSpeech 版本的最小依赖选择对应版本。
- 源码编译是官方推荐的另一种安装方式;可编辑模式安装需加 --use-pep517 参数。
- 服务端与客户端命令中的 config_file 为相对路径,需在包含 demos 目录的项目根目录下执行。
核心亮点
- 覆盖语音全链路,ASR/TTS/说话人验证/翻译等开箱即用
- 内置流式模型,适合实时交互场景
- 基于飞桨,支持 Python 简单调用,文档示例丰富
不足之处
- 依赖飞桨框架,与 PyTorch 生态集成不便
- 部分模型对中文优化,英文支持相对弱
- 文档/社区待观察
适用场景
- 智能语音助手开发
- 实时语音转写与字幕生成
- 语音交互系统原型验证
替代项目
ESPnet、SpeechBrain、Kaldi
上一篇:moonshine
下一篇:whispering-ui
同类项目推荐
Whispera
开源
Mac 上本地离线把语音秒变文字,录音即转写
AI-powered voice transcription app for macOS using WhisperKit
openless
开源
按住说话,松开即得润色文字,全应用通用
Hold a key, speak, release — AI-polished text appears at your cursor in any app. Op···
esp-skainet
开源
在 ESP32 上跑离线唤醒词和命令词识别
Espressif intelligent voice assistant
murmur
开源
按住说话,Mac 本地转文字,隐私不出门
Private, on-device voice dictation for macOS
speech-swift
开源
苹果芯片上跑本地语音AI,离线也能用
AI speech toolkit for Apple Silicon — ASR, TTS, speech-to-speech, VAD, and diarizat···
blurt
开源
按住说话,把语音和屏幕内容直接喂给终端 Agent
The keyboard for the agent era: dictation, copy text from screen, translation, snaps···
speech-to-phrase
开源
本地跑,只认你定义的短语,又快又准。
Fast and personalized local speech-to-text
petal
开源
菜单栏一点,本地把音频转成文字
Petal is a native macOS menu bar app for fast, local-first audio transcription.
TextNormalizationCoveringGrammar···
开源
用覆盖文法搞定英文俄文文本规范化,让语音更自然
Covering grammars for English and Russian text normalization