yihong0618/xiaogpt

这是什么？

核心功能

• 01将小米 AI 音箱的语音提问转发给 ChatGPT 或其他大模型。
• 02回答可通过音箱自带语音或 Edge TTS、Azure 等第三方引擎播放。
• 03支持流式响应和持续对话模式。
• 04可用命令行参数或 YAML/JSON 配置文件进行设置。
• 05提供 Docker 镜像便于部署。

适用场景

• 为家中的小米音箱增加对话式 AI 助手功能。
• 通过语音界面测试不同的大模型后端。
• 使用自选的语音合成服务定制音箱的播报声音。

快速上手

1. 1

   从 PyPI 安装 xiaogpt

   pip install -U --force-reinstall xiaogpt[locked]
2. 2

   用 MiService 获取音响的 DID（需先设置 MI_USER 和 MI_PASS）

   miservice list
3. 3

   设置你的 OpenAI API 密钥

   export OPENAI_API_KEY=${your_api_key}
4. 4

   使用音响型号和 ChatGPT API 运行 xiaogpt

   xiaogpt --hardware LX06 --use_chatgpt_api

使用前须知

• !需要小米 AI 音箱和小米账号。
• !使用大模型时通常需要付费的 API 密钥。
• !需要 Python 3.12 至 3.14。

标签

常见问题

xiaogpt 是什么？

让小米小爱音箱接入 ChatGPT 等大模型，语音提问后由音箱朗读回答。 xiaogpt 是一个 Python 工具，把小米 AI 音箱接入大语言模型。对音箱说出以“帮我”开头的问题后，内容会发送给所配置的模型，回答再通过音箱的语音合成播放出来。

xiaogpt 可以免费使用吗？用的什么许可证？

xiaogpt 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

xiaogpt 还在维护吗？

活跃维护中。xiaogpt 最近一次提交是在 2026年10月7日。

xiaogpt 适合用来做什么？

为家中的小米音箱增加对话式 AI 助手功能。 通过语音界面测试不同的大模型后端。 使用自选的语音合成服务定制音箱的播报声音。

xiaogpt 怎么安装和运行？

从 PyPI 安装 xiaogpt: pip install -U --force-reinstall xiaogpt[locked] 用 MiService 获取音响的 DID（需先设置 MI_USER 和 MI_PASS）: miservice list 设置你的 OpenAI API 密钥: export OPENAI_API_KEY=${your_api_key} 使用音响型号和 ChatGPT API 运行 xiaogpt: xiaogpt --hardware LX06 --use_chatgpt_api

在哪里获取 xiaogpt？

源代码和安装说明在 GitHub 上：https://github.com/yihong0618/xiaogpt