你是否想过,不用依赖云端API,就能在自己的电脑或机器人上运行一个真正“听得懂、答得快、说得出”的语音助手?Hugging Face 推出的 speech-to-speech 项目,正是这样一套开箱即用、模块清晰、完全开源的端到端语音智能体(Voice Agent)框架。它把语音识别(STT)、大语言模型(LLM)推理、语音合成(TTS)和人声活动检测(VAD)四大关键环节串联成一条低延迟流水线,并统一暴露为标准 WebSocket 接口——这意味着,你不仅能本地部署,还能无缝对接现有 OpenAI Realtime 客户端,甚至把它装进教育机器人、智能家居中台或无障碍辅助设备里。
核心功能
- 全链路模块化设计:VAD(语音活动检测)→ STT(语音转文本)→ LLM(大模型理解与生成)→ TTS(文本转语音),每个环节都可独立替换,支持多种开源模型自由组合
- OpenAI Realtime 协议兼容:提供标准 WebSocket API,前端无需改代码,只需切换 endpoint 地址,即可从调用 OpenAI 切换为调用本地服务
- 真正的本地化部署能力:LLM 模块支持直连 vLLM、llama.cpp 或 Hugging Face 推理端点,全程不依赖外部云服务,隐私与响应速度兼得
- 生产级稳定性验证:已在数千台 Reachy Mini 教育机器人中稳定运行,经受真实场景下的多轮对话、噪声环境与长时交互考验
- 轻量易集成:通过 pip 一键安装,Python API 简洁直观,也支持 Docker 快速容器化部署,适合嵌入边缘设备或私有服务器
- 跨平台语音支持:内置多语言 STT/TTS 模型(如 Whisper、Coqui TTS、Bark 等),轻松适配中英日韩等主流语种的语音交互需求
适合哪些人用
如果你是AI 应用开发者,想快速构建离线语音助手、智能硬件对话模块或教育机器人交互系统;如果你是企业技术负责人,需要在内网部署合规、可控、无数据外泄风险的语音服务;如果你是高校研究者或创客爱好者,希望深入理解语音-语言-语音闭环的技术实现,或基于此做二次开发与教学演示——那么 speech-to-speech 就是你正在寻找的那套「靠谱又开放」的基础设施。
快速上手
只需三步,5 分钟启动本地语音对话服务:
- 安装:执行
pip install speech-to-speech(支持 Python 3.9+) - 启动服务:运行
s2s-server --stt-model "openai/whisper-small" --llm-model "Qwen/Qwen2-1.5B-Instruct" --tts-model "tts_models/multilingual/multi-dataset/xtts_v2"(参数可根据硬件调整,小模型可在普通笔记本流畅运行) - 连接测试:用任意支持 OpenAI Realtime API 的客户端(如官方 demo 页面或自研前端),将 endpoint 指向
ws://localhost:8000/v1/realtime即可开始语音对话
详细配置说明、模型推荐列表与 Docker Compose 示例均在 GitHub Wiki 和 README 中提供,零基础用户也能顺利跑通首个 demo。
项目信息
huggingface/speech-to-speech
GitHub
Build local voice agents with open-source models
5.5k
今日 +533 stars this week
Stars
672
Forks
Python
Apache-2.0
编程语言:Python|GitHub Star 数:5494|开源协议:Apache-2.0|GitHub 项目地址
这不是又一个“玩具级”语音 Demo,而是一套已在真实机器人产品中规模化落地、兼顾工程鲁棒性与学术开放性的工业级语音智能体底座——如果你想掌控语音交互的每一行代码,就从它开始。




