xiaogpt

环境要求

• Python 环境，可用 pip 安装包
• 一个小米账号（小爱音箱已绑定）
• 一台小米 AI 音箱，知道其型号（如 LX06）
• 至少一个大模型服务的 API Key（如 OpenAI、Gemini、通义千问、Kimi 等）

安装与启动步骤

1. 1安装 MiService

   用于查询和操作小米音箱的依赖包，先装它才能拿到音箱 DID。

   pip install miservice_fork

   复制

2. 2设置小米账号

   把小米账号与密码写入环境变量，供 micli 登录使用。Windows 请用 set 或 $env: 写法。

   export MI_USER=xxx
   export MI_PASS=xxx

   复制

3. 3获取音箱 DID

   执行后从返回结果中找到自己音箱对应的 DID，记下来备用。

   micli list

   复制

4. 4设置 MI_DID

   把上一步拿到的 DID 写入环境变量，xiaogpt 运行时会读取它。

   export MI_DID=xxx

   复制

5. 5安装 xiaogpt

   从 PyPI 安装带 locked 依赖的 xiaogpt 主程序。

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

   复制

6. 6配置模型密钥

   设置所选大模型的 API Key 环境变量，例如 OpenAI 用 OPENAI_API_KEY。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

7. 7启动 xiaogpt

   --hardware 填音箱型号（音箱底部可查，也可用 micli mina 查询）。

   xiaogpt --hardware LX06 --use_chatgpt_api

   复制

8. 8可选增强启动

   加 --mute_xiaoai 可快速停掉小爱原回答，--stream 开启流式响应更快。

   xiaogpt --hardware LX06 --mute_xiaoai --stream

   复制

关键配置

如何确认成功

运行后对小爱同学说以“帮我”开头的问题，音箱会用 TTS 播报大模型的回答即成功。

常见问题

注意事项

• 记得设置 MI_DID，否则无法定位到你的音箱。
• 想获得更好的 TTS 效果可加 --tts edge，也支持 --tts openai、--tts azure、--tts fish 等。
• 除 ChatGPT 外还支持 New Bing、ChatGLM、Gemini、豆包、Moonshot、01、Llama3、通义千问等后端。
• 也可 git clone 项目后本地运行，例如 python3 xiaogpt.py --hardware LX06。