xiaozhi-sdk 0.5.0

一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。

小智SDK ｜ 一句话命令

基于虾哥的 小智esp32 websocket 通讯协议 实现的 Python SDK。

一个用于连接和控制小智设备的 Python SDK。支持以下功能：

• 实时音频通信
• MCP 工具集成
• 设备管理与控制
• 跨平台支持（Windows、macOS、Linux、树莓派，支持 x64 和 ARM64 架构）

---

📦 安装

pip install uv
uv pip install xiaozhi-sdk -U

---

🚀 快速开始

1. 终端使用

最简单的方式是通过终端直接连接设备：

查看帮助信息

xiaozhi --help

连接设备

# 默认本机 mac 地址
xiaozhi

# 指定 mac 地址
xiaozhi 00:22:44:66:88:00

# 更多常用操作
## --url 指定服务端 websocket 地址
## --wake_word 指定唤醒词
xiaozhi 00:22:44:66:88:00 \
  --url ws://127.0.0.1:8180 \
  --wake_word "你好啊"

2. 编程使用 (高阶用法)

参考 examples 文件中的示例代码，可以快速开始使用 SDK。

---

✅ 运行测试

# 安装开发依赖
uv sync --group dev

# 运行测试
uv run pytest

---

🫡 致敬

• 🫡 虾哥的 xiaozhi-esp32 项目