PY-XIAOZHI概述
py-xiaozhi是一款使用Python实现的AI小智语音客户端，基于原生小智ESP32代码移植，打造了一款纯Python实现的AI语音客户端。用户无需额外硬件，就能在台式机或笔记本上体验实时对话和语音交互。项目原生支持MQTT与WSS双协议，能够打断并持续对话，后续协议扩展仅需仿照官方实现即可。核心模块涵盖音乐、灯光、音量、定时器、Home Assistant控制及摄像头IoT操控，视觉识别则依赖外部大模型API Key方可启用。
智能家居与IoT集成
直接对接Home Assistant平台，通过HTTP API控制灯具、开关、传感器等设备；支持虚拟设备如倒计时器，也可接入物理温度传感器、摄像头等硬件。模块化设计令设备扩展与注册流程简易清晰。
网络音乐播放
借助pygame打造高性能播放器，涵盖播放、暂停、停止、进度调节、歌词显示和本地缓存功能，保证长播放稳定性并减少网络波动带来的中断。
唤醒与安全传输
内置唤醒词激活功能（默认关闭），无需手动点击即可启动交互。全程音频通过WSS协议加密传输，防止数据窃听与篡改。
使用体验与扩展
界面与命令行双模式
提供直观的图形化界面，展示小智的表情与对话文本，增强用户沉浸感；亦支持命令行运行，适配资源受限或无GUI的环境。
跨平台兼容性
兼容Windows 10及以上、macOS 10.15及以上和各主流Linux发行版，部署前仅需保证Python 3.9–3.12环境、麦克风与扬声器可用即可。
稳定性与自动化
自动获取并管理MAC地址，避免网络冲突；首次运行自动复制验证码并唤起浏览器，简化认证流程；模块化代码与类封装方便二次开发，同时修复断线重连、跨平台兼容等多项细节问题。
结语
py-xiaozhi为缺乏硬件条件的开发者与爱好者提供了一条低门槛体验AI小智语音功能的途径。通过开源、模块化设计和多协议支持，它既适合作为学习案例，也可直接用于智能家居场景的语音控制与多模态交互。
