py-xiaozhi

概述

Py-Xiaozhi是一个基于Python实现的小智AI语音助手，允许用户在没有专用硬件的情况下体验完整的语音交互功能。项目提供AI语音交互、视觉多模态能力、智能唤醒检测、自动对话模式和MCP工具生态集成。支持多种界面模式，包括GUI（PySide6 + QML）、命令行界面和GPIO模式，兼容Windows、macOS和Linux等跨平台系统。项目架构包含插件系统、多种通信协议（WebSocket/MQTT）以及多种音频编解码功能。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• music_play

  Play music through the music player

  试试:Play some relaxing music试试:Play the latest hit songs
• camera_capture

  Capture images using the camera

  试试:Take a photo of the current view试试:Capture an image for analysis
• screenshot

  Take a screenshot of the current display

  试试:Capture a screenshot of my screen试试:Take a picture of what I'm seeing
• app_control

  Control running applications

  试试:Open the web browser试试:Close the music player
• weather_query

  Get weather information for a location

  试试:What's the weather like today?试试:Check the forecast for tomorrow
• volume_control

  Adjust system volume levels

  试试:Set the volume to 50%试试:Increase the volume

可对比工具

安装

# 克隆项目
git clone https://github.com/huangjunsen0406/py-xiaozhi.git
cd py-xiaozhi

# 基础安装（CLI/GPIO模式）
uv sync
# 或: pip install -e .

# GUI模式安装（额外依赖）
uv sync --extra gui
# 或: pip install -e '.[gui]'

# 运行应用
python main.py                 # GUI模式（默认）
python main.py --mode cli      # CLI模式
python main.py --protocol mqtt # MQTT协议

FAQ

Py-Xiaozhi的系统要求是什么？

Python >= 3.10，麦克风和扬声器，稳定的网络连接。兼容Windows 10+、macOS 10.15+和Linux系统。

如何向系统添加自定义MCP工具？

可以通过`src/plugins/mcp/tools/`目录下的插件系统添加自定义工具。项目支持通过自定义实现扩展MCP工具生态。

Py-Xiaozhi能否离线工作？

唤醒词检测基于Sherpa-ONNX离线识别，但部分功能需要网络连接以进行云端AI处理。

py-xiaozhi 对比