Metadata-Version: 2.4
Name: xiaozhi-sdk
Version: 0.4.0
Summary: 一个用于连接和控制小智智能设备的Python SDK，支持实时音频通信、MCP工具集成和设备管理功能。
Author-email: dairoot <623815825@qq.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/dairoot/xiaozhi-sdk
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: websockets>=15.0.1
Requires-Dist: aiohttp
Requires-Dist: av
Requires-Dist: opuslib
Requires-Dist: requests
Requires-Dist: sounddevice
Requires-Dist: python-socks
Requires-Dist: click
Requires-Dist: colorlog
Requires-Dist: soundfile>=0.13.1
Requires-Dist: pydub>=0.25.1
Requires-Dist: pillow>=11.3.0
Dynamic: license-file

# 小智SDK ｜ 一句话命令

[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/badge/pypi-xiaozhi--sdk-blue.svg)](https://pypi.org/project/xiaozhi-sdk/)

基于虾哥的 [小智esp32 websocket 通讯协议](https://github.com/78/xiaozhi-esp32/blob/main/docs/websocket.md) 实现的 Python SDK。

一个用于连接和控制小智设备的 Python SDK。支持以下功能：
- 实时音频通信
- MCP 工具集成
- 设备管理与控制
- 跨平台支持（Windows、macOS、Linux、树莓派，支持 x64 和 ARM64 架构）

---

## 📦 安装

```bash
pip install uv
uv pip install xiaozhi-sdk -U
```

---

## 🚀 快速开始

### 1. 终端使用

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

#### 查看帮助信息

```bash
xiaozhi --help
```

#### 连接设备

```bash
# 默认本机 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](examples/) 文件中的示例代码，可以快速开始使用 SDK。


---

## ✅ 运行测试

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

# 运行测试
uv run pytest
```


---

## 🫡 致敬

- 🫡 虾哥的 [xiaozhi-esp32](https://github.com/78/xiaozhi-esp32) 项目
