Python实现的AI小智语音客户端，PY-XIAOZHI

py-xiaozhi是一款使用Python实现的AI小智语音客户端，基于原生小智ESP32代码移植，打造了一款纯Python实现的AI语音客户端。用户无需额外硬件，就能在台式机或笔记本上体验实时对话和语音交互。项目原生支持MQTT与WSS双协议，能够打断并持续对话，后续协议扩展仅需仿照官方实现即可。核心模块涵盖音乐、灯光、音量、定时器、Home Assistant控制及摄像头IoT操控，视觉识别则依赖外部大模型API Key方可启用。

支持语音输入、识别和合成，能模拟自然语言对话流，打断式交互保证响应及时。启用自动对话后，用户与小智的多轮对话无须重复唤醒，提升交互连贯性。

Python实现的AI小智语音客户端，PY-XIAOZHI 第5张插图

智能家居与IoT集成
直接对接Home Assistant平台，通过HTTP API控制灯具、开关、传感器等设备；支持虚拟设备如倒计时器，也可接入物理温度传感器、摄像头等硬件。模块化设计令设备扩展与注册流程简易清晰。

网络音乐播放
借助pygame打造高性能播放器，涵盖播放、暂停、停止、进度调节、歌词显示和本地缓存功能，保证长播放稳定性并减少网络波动带来的中断。

唤醒与安全传输
内置唤醒词激活功能（默认关闭），无需手动点击即可启动交互。全程音频通过WSS协议加密传输，防止数据窃听与篡改。

使用体验与扩展
界面与命令行双模式
提供直观的图形化界面，展示小智的表情与对话文本，增强用户沉浸感；亦支持命令行运行，适配资源受限或无GUI的环境。

跨平台兼容性
兼容Windows 10及以上、macOS 10.15及以上和各主流Linux发行版，部署前仅需保证Python 3.9–3.12环境、麦克风与扬声器可用即可。

稳定性与自动化
自动获取并管理MAC地址，避免网络冲突；首次运行自动复制验证码并唤起浏览器，简化认证流程；模块化代码与类封装方便二次开发，同时修复断线重连、跨平台兼容等多项细节问题。