py-xiaozhi
活跃·★ 3.5k·MIT·更新于 2026-09-11
py-xiaozhi 是用 Python 实现的小智语音客户端，目的是通过代码学习，以及在没有硬件的条件下体验小智的语音功能。它移植自 xiaozhi-esp32 项目，README 为中文并附英文版本。
功能包括：语音交互、视觉多模态理解、使用离线 Sherpa-ONNX 识别的可配置唤醒词，以及 MCP 工具生态：系统控制、日程管理、倒计时器、在线音乐播放、12306 火车票查询、通过必应搜索、菜谱库、高德地图、传统八字命理工具和摄像头工具。它还带有 IoT 设备管理、音频处理（Opus、重采样、语音活动检测、WebRTC 回声消除）、基于 PyQt5 的图形界面、适用于嵌入式或无界面环境的命令行模式、系统托盘，以及 WSS 加密音频传输。需要 Python 3.9 到 3.12、麦克风和扬声器以及稳定的互联网连接，推荐至少 4 GB 内存（建议 8 GB），唤醒词还需要另行下载模型。README 要求用户每次更新之后重新安装 pip 依赖。采用 MIT 许可证。
#AI 语音助手#Python#多模态AI#物联网集成#语音处理
01
功能特性
01AI语音交互
02视觉多模态
03智能唤醒
04MCP工具生态系统
05IoT设备集成
02
为什么选择它
+让你在没有 ESP32 硬件的情况下，也能在电脑上体验小智语音助手，有图形界面和命令行两种模式。
+基于 Sherpa-ONNX 的离线唤醒词检测，另有回声消除、语音活动检测和加密的 WSS 音频传输。
+丰富的 MCP 工具（日程、定时器、音乐、火车票、网页搜索、地图等）和 IoT 设备管理。
+跨平台，采用 MIT 许可证，并有文档和视频教程。
03
权衡点
!AI 功能依赖小智服务，它是客户端，而不是自成一体的助手。
!需要 Python 3.9 到 3.12、可用的音频设备、网络连接，唤醒词还需要另行下载模型。
!README 要求用户每次更新后重新安装 pip 依赖，并且主要是中文。
05
维护状况检查
活跃检查日期: 2026-10-25
- 最近提交
- 2026-09-11
- 近 90 天提交数
- 5
- 近 90 天发布数
- 1
- 最新发布
- v2.1.2 (2026-09-11)
- 未关闭 issue
- 8
- 近期 issue 至少有一条评论的比例
- 6/10
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #317 [Improvement] py-xiaozhi should be only a library4 条评论 · 2026-08-07
- #316 Looking for Open-Source Infrastructure Sponsorship: Storage, CDN or Server1 条评论 · 2026-07-28
- #325 [Security] TLS 证书验证在全部传输层被禁用（WebSocket / OTA / 激活 / MQTT），与文档中 "certificate verification" 的说明不符0 条评论 · 2026-10-09
- #323 Optional consent-based memory for recurring voice sessions0 条评论 · 2026-09-28
- #322 Feature Suggestion: Optional token metering & paid API key support via `neuforge-pay`0 条评论 · 2026-09-12
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 想在电脑上体验小智语音助手，不需要 ESP32 硬件。
- 想要基于 Sherpa-ONNX 的离线唤醒词、回声消除，以及图形界面或命令行模式。
- 想要现成的 MCP 工具，比如日程、计时器、音乐、火车票、网页搜索和地图。
建议换别的情况
- 你想要独立运行的助手：AI 功能依赖小智服务。
- 你无法满足 Python 3.9 到 3.12、可用的音频设备和联网这些条件。
- 你想自托管后端：那是服务端项目做的事。
06
与同类的区别
vs xiaozhi-esp32-server★ 11.1kxiaozhi-esp32-server 是小智设备的后端。py-xiaozhi 是在电脑上扮演设备角色的客户端。
07
兼容性
Windows
原生支持
已通过文档验证
macOS
原生支持
已通过文档验证
Linux
原生支持
已通过文档验证
08
快速开始
1
$ pip install -r requirements.txt
09
使用场景
↳学习Python AI语音客户端开发
↳在PC上体验AI小智语音功能
↳远程或自动化智能设备控制
10
同类工具
⚡热门对决:
收录于以下清单
评论
登录后发表评论
暂无评论，来发表第一条吧