Files
open-xiaoai/examples/xiaozhi

Open-XiaoAI x 小智 AI

Open-XiaoAI 的 Python 版 Server 端,用来演示小爱音箱接入小智 AI

Note

该演示使用的 Python 版小智 AI 客户端基于 py-xiaozhi 项目,特此鸣谢。

环境准备

为了能够正常编译运行该项目,你需要安装以下依赖环境/工具:

如果你是 macOS 系统,还需要手动安装 Opus 👉 brew install opus

编译运行

Note

请先确认你已经将小爱音箱刷机成功,并安装运行了 Rust 补丁程序 👉 教程,否则该 Python Server 端启动后收不到音频输入,将无法正常工作。

# 安装 Python 依赖
uv sync

# 编译运行
uv run main.py

如果你只是想体验一下小智 AI,请使用以下命令启动:

uv run main.py --mode xiaozhi

该模式下使用电脑的麦克风和扬声器作为音频输入输出设备,无需连接小爱音箱。

注意事项

首次启动会自动打开小智 AI 管理后台,然后提供一个验证码用来绑定设备。

请按照提示注册你的小智 AI 账号,然后创建 Agent 绑定设备即可开始体验。

Note

本项目只是一个简单的演示程序,抛砖引玉。如果你想要更多的功能,比如唤醒词识别、语音转文字、连续对话等,可以参考开源的 xiaozhi-esp32-server 项目,借助 Python 丰富的 AI 生态自行实现。