py-xiaozhi:零门槛玩转 Python 语音AI助手,从装到玩全讲透

py-xiaozhi:零门槛玩转 Python 语音AI助手,从装到玩全讲透【免费下载链接】py-xiaozhi基于Python的Xiaozhi AI适用于想要完整Xiaozhi体验而无需拥有专用硬件的用户。项目地址: https://gitcode.com/huangjunsen0406/py-xiaozhipy-xiaozhi 是一个基于 Python 的语音 AI 助手客户端,不用专用硬件,一台电脑或树莓派就能拥有完整的小智体验。这篇文章带你从安装、唤醒、音频路由到智能家居,把主流玩法一次讲清,读完就能上手。五分钟装好 py-xiaozhi,第一次跟它说话环境要求很简单:Python 3.10 以上、一个麦克风加扬声器,网络别太差就行。git clone https://gitcode.com/huangjunsen0406/py-xiaozhi cd py-xiaozhi uv sync # 或者 pip install -e . python main.py # 无图形环境可加 --mode cli三种说话方式启动后是简洁的主界面。和它对话有三种姿势:按住CtrlJ说话、松手自动发送,适合嘈杂环境,不怕误触发;按CtrlK开自动对话,你一句它一句,来回轮流;如果开了回声消除,还会进入实时模式,随时插话都能打断它。嫌它话太多,CtrlQ一声令下立刻闭嘴。让它更灵敏地听懂你换个专属唤醒词唤醒基于 Sherpa-ONNX 离线识别,仓库里models/zh和models/en自带中英文模型,下载完就能用。想叫它别的名字?编辑对应目录的keywords.txt,再在配置里同步改一下唤醒词即可,步骤都写在语音唤醒文档里。打开回声消除,随时插话AI 开口时,麦克风会把它的声音也录进去,处理不好就出现自问自答。py-xiaozhi 内置了 WebRTC 回声消除引擎(aec_engine.py),把AEC_OPTIONS.ENABLED设为true就能消掉它自己播放的声音,打断也稳了。延迟补偿、噪声抑制这些参数怎么调,回声消除配置指南里都有现成答案。把快捷键变成肌肉记忆除了上面提到的,CtrlM循环切换交互模式,CtrlW快速隐藏或恢复主窗口。整套快捷键是全局的,程序挂在后台也能触发,完整列表见快捷键说明。声音去哪儿:多设备输出与音频路由 想让声音同时出现在几个地方?多设备同时出声在设置的音频设备里选多输出设备,勾选扬声器和耳机,声音就能同时到达,客厅卧室各听各的,互不干扰。用聚合设备做复杂路由需要把输入输出绑在一起时,可以创建聚合设备,把多个物理设备合成一个逻辑设备,采样率和时钟源还能单独配,路由怎么绕都不慌。连接你的设备世界 助手不该只会在屏幕里说话。用 py-xiaozhi 的 MCP 工具扩展能力src/mcp/ 下内置了一整套工具:播音乐、调音量、查天气、控摄像头、截屏幕,语音一句话就能驱动。想接外部能力也行,MCP 协议支持接入任意兼容服务,生态是开放的。一句话控制 Home Assistant智能家居玩家可以直接接上 Home Assistant MCP 插件,它走 WebSocket 直连小智服务端,不经过中转,延迟更低。装好之后,把客厅灯调暗开启电影模式这类话就能真的执行,查设备状态、切场景都支持。配置细节、协议选择、依赖安装,翻一翻官方文档目录都有专门章节,遇到坑基本都能查到对应说明。【免费下载链接】py-xiaozhi基于Python的Xiaozhi AI适用于想要完整Xiaozhi体验而无需拥有专用硬件的用户。项目地址: https://gitcode.com/huangjunsen0406/py-xiaozhi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考