xiaogpt

https://user-images.githubusercontent.com/15976103/226803357-72f87a41-a15b-409e-94f5-e2d262eecd53.mp4

用小米AI音箱玩ChatGPT及其他大模型

支持的AI类型

• ChatGPT
• New Bing
• ChatGLM
• Gemini
• Doubao
• Moonshot
• 01
• Llama3
• 通义千问

获取小米音响DID

系统和 Shell	Linux *sh	Windows CMD 用户	Windows PowerShell 用户
1、安装包	pip install miservice_fork	pip install miservice_fork	pip install miservice_fork
2、设置变量	export MI_USER=xxx export MI_PASS=xxx	set MI_USER=xxx set MI_PASS=xxx	$env:MI_USER="xxx" $env:MI_PASS="xxx"
3、取得 MI_DID	micli list	micli list	micli list
4、设置 MI_DID	export MI_DID=xxx	set MI_DID=xxx	$env:MI_DID="xxx"

• 注意不同shell对环境变量的处理是不同的，尤其是powershell赋值时，可能需要双引号来包括值。
• 如果获取did报错时，请更换一下无线网络，有很大概率解决问题。

一点原理

不用root使用小爱同学和ChatGPT交互折腾记

准备

1. ChatGPT id
2. 小爱音响
3. 能正常联网的环境或proxy
4. python3.8+

使用

• pip install -U --force-reinstall xiaogpt[locked]
• 参考我fork的MiService项目README并在本地terminal跑micli list拿到你音响的DID成功别忘了设置export MI_DID=xxx这个MI_DID用
• run xiaogpt --hardware ${your_hardware} --use_chatgpt_api hardware你看小爱屁股上有型号，输入进来，如果在屁股上找不到或者型号不对，可以用micli mina找到型号
• 跑起来之后就可以问小爱同学问题了，“帮我"开头的问题，会发送一份给ChatGPT然后小爱同学用tts回答
• 如果上面不可用，可以尝试用手机抓包，https://userprofile.mina.mi.com/device_profile/v2/conversation找到cookie利用--cookie '${cookie}' cookie别忘了用单引号包裹
• 默认用目前ubus,如果你的设备不支持ubus可以使用--use_command来使用command来tts
• 使用--mute_xiaoai选项，可以快速停掉小爱的回答
• 使用--account ${account} --password ${password}
• 如果有能力可以自行替换唤醒词，也可以去掉唤醒词
• 使用--use_chatgpt_api的api那样可以更流畅的对话，速度特别快，达到了对话的体验，openai api,命令--use_chatgpt_api
• 如果你遇到了墙需要用Cloudflare Workers替换api_base请使用--api_base ${url}来替换。请注意，此处你输入的api应该是'https://xxxx/v1'的字样，域名需要用引号包裹
• --use_moonshot_api和其他模型请参考下文
• 可以跟小爱说开始持续对话自动进入持续对话状态，结束持续对话结束持续对话状态。
• 可以使用--tts edge来获取更好的tts能力
• 可以使用--tts fish --fish_api_key <your-fish-key> --fish_voice_key <fish-voice>来获取fish-audio能力（如何获取fish voice见下）
• 可以使用--tts openai来获取openai tts能力
• 可以使用--tts azure --azure_tts_speech_key <your-speech-key>来获取Azure TTS能力
• 可以使用--use_langchain替代--use_chatgpt_api来调用LangChain（默认chatgpt）服务，实现上网检索、数学运算..

e.g.

export OPENAI_API_KEY=${your_api_key}
xiaogpt --hardware LX06 --use_chatgpt_api
# 或
xiaogpt --hardware LX06 --cookie ${cookie} --use_chatgpt_api
# 如果你想直接输入账号密码
xiaogpt --hardware LX06 --account ${your_xiaomi_account} --password ${your_password} --use_chatgpt_api
# 如果你想mute小米的回答
xiaogpt --hardware LX06  --mute_xiaoai --use_chatgpt_api
# 使用流式响应，获得更快的响应
xiaogpt --hardware LX06  --mute_xiaoai --stream
# 如果你想使用google的gemini
xiaogpt --hardware LX06  --mute_xiaoai --use_gemini --gemini_key ${gemini_key}
# 如果你想使用自己的google gemini服务
python3 xiaogpt.py --hardware LX06  --mute_xiaoai --use_gemini --gemini_key ${gemini_key} --gemini_api_domain ${gemini_api_domain}
# 如果你想使用阿里的通义千问
xiaogpt --硬件 LX06  --mute_xiaoai --use_qwen --qwen_key ${qwen_key}
# 如果你想使用kimi
xiaogpt --硬件 LX06  --mute_xiaoai --use_moonshot_api --moonshot_api_key ${moonshot_api_key}
# 如果你想使用llama3
xiaogpt --硬件 LX06  --mute_xiaoai --use_llama --llama_api_key ${llama_api_key}
# 如果你想使用01
xiaogpt --硬件 LX06  --mute_xiaoai --use_yi_api --ti_api_key ${yi_api_key}
# 如果你想使用LangChain+SerpApi实现上网检索或其他本地服务（目前仅支持stream模式）
export OPENAI_API_KEY=${your_api_key}
export SERPAPI_API_KEY=${your_serpapi_key}
xiaogpt --硬件 Lx06 --use_langchain --mute_xiaoai --stream --openai_key ${your_api_key} --serpapi_api_key ${your_serpapi_key}

使用git clone运行

export OPENAI_API_KEY=${your_api_key}
python3 xiaogpt.py --硬件 LX06
# 或
python3 xiaogpt.py --硬件 LX06 --cookie ${cookie}
# 如果你想直接输入账号密码
python3 xiaogpt.py --硬件 LX06 --account ${your_xiaomi_account} --password ${your_password} --use_chatgpt_api
# 如果你想mute小米的回答
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai
# 使用流式响应，获得更快的响应
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --stream
# 如果你想使用ChatGLM api
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --use_glm --glm_key ${glm_key}
# 如果你想使用google的gemini
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --use_gemini --gemini_key ${gemini_key}
# 如果你想使用自己的google gemini服务
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --use_gemini --gemini_key ${gemini_key} --gemini_api_domain ${gemini_api_domain}
# 如果你想使用阿里的通义千问
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --use_qwen --qwen_key ${qwen_key}
# 如果你想使用kimi
xiaogpt --硬件 LX06  --mute_xiaoai --use_moonshot_api --moonshot_api_key ${moonshot_api_key}
# 如果你想使用01
xiaogpt --硬件 LX06  --mute_xiaoai --use_yi_api --ti_api_key ${yi_api_key}
# 如果你想使用豆包
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --use_doubao --stream --volc_access_key xxxx --volc_secret_key xxx
# 如果你想使用llama3
python3 xiaogpt.py --硬件 LX06  --mute_xiaoai --use_llama --llama_api_key ${llama_api_key}
# 如果你想使用LangChain+SerpApi实现上网检索或其他本地服务（目前仅支持stream模式）
export OPENAI_API_KEY=${your_api_key}
export SERPAPI_API_KEY=${your_serpapi_key}
python3 xiaogpt.py --硬件 Lx06 --use_langchain --mute_xiaoai --stream --openai_key ${your_api_key} --serpapi_api_key ${your_serpapi_key}

config.yaml

如果想通过单一配置文件启动也是可以的，可以通过--config参数指定配置文件，config文件必须是合法的Yaml或JSON格式 参数优先级

• cli args > default > config

python3 xiaogpt.py --config xiao_config.yaml

# 或者
xiaogpt --config xiao_config.yaml

或者

cp xiao_config.yaml.example xiao_config.yaml
python3 xiaogpt.py

若要指定 OpenAI 的模型参数，如 model, temperate, top_p，请在 config.yaml 中指定：

gpt_options:
  temperature: 0.9
  top_p: 0.9

具体参数作用请参考 Open AI API 文档。 ChatGLM 文档

配置项说明

参数	说明	默认值	可选值
hardware	设备型号
account	小爱账户
password	小爱账户密码
openai_key	OpenAI 的 API 密钥
moonshot_api_key	Moonshot Kimi 的 API 密钥
yi_api_key	01 万物的 API 密钥
llama_api_key	Groq 的 Llama3 API 密钥
serpapi_api_key	SerpAPI 的密钥，参考 SerpAPI
glm_key	ChatGLM 的 API 密钥
gemini_key	Gemini 的 API 密钥 参考
gemini_api_domain	Gemini 的自定义域名 参考
qwen_key	Qwen 的 API 密钥 参考
cookie	小爱账户 Cookie（如果使用上述密码登录，可不填）
mi_did	设备 DID
use_command	使用 MI Command 与小爱交互	false
mute_xiaoai	快速停止小爱自身的回答	true
verbose	是否打印详细日志	false
bot	使用的机器人类型，目前支持 ChatGPT API、New Bing、Qwen、Gemini	ChatGPT API
tts	使用的 TTS 类型	mi	edge、OpenAI、Azure、Volc、Baidu、Google、Minimax
tts_options	TTS 参数字典，参考 Tetos 获取可用参数
prompt	自定义提示语	请用100字以内回答
keyword	自定义请求词列表	["请"]
change_prompt_keyword	更改提示词触发列表	["更改提示词"]
start_conversation	开始持续对话关键词	开始持续对话
end_conversation	结束持续对话关键词	结束持续对话
stream	使用流式响应，获得更快的响应	true
proxy	支持 HTTP 代理，传入 HTTP 代理 URL	""
gpt_options	OpenAI API 的参数字典	{}
deployment_id	Azure OpenAI 服务的部署 ID	参考此如何找到部署ID
api_base	如果需要替换默认的 API 地址，或者使用 Azure OpenAI 服务	例如：https://abc-def.openai.azure.com/
volc_access_key	火山引擎的访问密钥，请在这里获取
volc_secret_key	火山引擎的秘密密钥，请在这里获取

注意

1. 请开启小爱同学的蓝牙
2. 如果要更改提示词和 PROMPT 在代码最上面自行更改
3. 目前已知 LX04、X10A 和 L05B L05C 可能需要使用 --use_command，否则可能会出现终端能输出 GPT 的回复但小爱同学不回答 GPT 的情况。这几个型号也只支持小爱原本的 tts.
4. 在 wsl 使用时，需要设置代理为 <http://wls 的 ip:port(vpn 的代理端口)>, 否则会出现连接超时的情况，详情 报错：Error communicating with OpenAI

QA

1. 用破解么？不用
2. 你做这玩意也没用啊？确实。。。但是挺好玩的，有用对你来说没用，对我们来说不一定呀
3. 想把它变得更好？PR Issue always welcome.
4. 还有问题？提 Issue 哈哈
5. Exception: Error https://api2.mina.mi.com/admin/v2/device_list?master=0&requestId=app_ios_xxx: Login failed @KJZH001
   这是由于小米风控导致，海外地区无法登录大陆的账户，请尝试 cookie 登录 无法抓包的可以在本地部署完毕项目后再用户文件夹C:\Users\用户名下面找到.mi.token，然后扔到你无法登录的服务器去
   若是 linux 则请放到当前用户的 home 文件夹，此时你可以重新执行先前的命令，不出意外即可正常登录（但 cookie 可能会过一段时间失效，需要重新获取）
   详情请见 https://github.com/yihong0618/xiaogpt/issues/332

视频教程

https://www.youtube.com/watch?v=K4YA8YwzOOA

Docker

常规用法

X86/ARM Docker Image: yihong0618/xiaogpt

docker run -e OPENAI_API_KEY=<your-openapi-key> yihong0618/xiaogpt <命令行参数>

如

docker run -e OPENAI_API_KEY=<your-openapi-key> yihong0618/xiaogpt --account=<your-xiaomi-account> --password=<your-xiaomi-password> --hardware=<your-xiaomi-hardware> --use_chatgpt_api

使用配置文件

xiaogpt 的配置文件可通过指定 volume /config，以及指定参数--config 来处理，如

docker run -v <your-config-dir>:/config yihong0618/xiaogpt --config=/config/config.yaml

网络使用 host 模型

docker run -v <your-config-dir>:/config --network=host yihong0618/xiaogpt --config=/config/config.yaml

本地编译 Docker Image

 docker build -t xiaogpt .

如果在安装依赖时构建失败或安装缓慢时，可以在构建 Docker 镜像时使用 --build-arg 参数来指定国内源地址：

docker build --build-arg PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple -t xiaogpt .

如果需要在 Apple M1/M2上编译x86

 docker buildx build --platform=linux/amd64 -t xiaogpt-x86 .

第三方 TTS

我们目前支持是三种第三方 TTS：edge/openai/azure/volc/baidu/google

edge-tts 提供了类似微软 tts 的能力 azure-tts 提供了微软 azure tts 的能力 openai-tts 提供了类似 openai tts 的能力 fish-tts 提供了 fish tts 的能力

Usage

你可以通过参数 tts, 来启用它

tts: edge

For edge 查看更多语言支持，从中选择一个

edge-tts --list-voices

如果你想使用 fish-tts

1. 注册 https://fish.audio/zh-CN/go-api/ 拿到 api key
2. 选择你想要的声音自建声音或者使用热门声音 https://fish.audio/zh-CN/text-to-speech/?modelId=e80ea225770f42f79d50aa98be3cedfc 其中 e80ea225770f42f79d50aa98be3cedfc 就声音的 key id
3. python3 xiaogpt.py --hardware LX06 --account xxxx --password xxxxx --use_chatgpt_api --mute_xiaoai --stream --tts fish --fish_api_key xxxxx --fish_voice_key xxxxx
4. 或者在 xiao_config.yaml 中配置

tts: fish 
# TTS 参数字典，参考 https://github.com/frostming/tetos 获取可用参数
tts_options: {
    "api_key": "xxxxx",
    "voice": "xxxxxx"
}

在容器中使用 edge-tts/azure-tts/openai-tts/volc/google/baidu/fish

由于 Edge TTS 启动了一个本地的 HTTP 服务，所以需要将容器的端口映射到宿主机上，并且指定本地机器的 hostname:

docker run -v <your-config-dir>:/config -p 9527:9527 -e XIAOGPT_HOSTNAME=<your ip> yihong0618/xiaogpt --config=/config/config.yaml

注意端口必须映射为与容器内一致，XIAOGPT_HOSTNAME 需要设置为宿主机的 IP 地址，否则小爱无法正常播放语音。

推荐的类似项目

• XiaoBot -> Go 语言版本的 Fork, 带支持不同平台的 UI
• MiGPT -> Node.js 版，支持流式响应和长短期记忆

感谢

• xiaomi
• PDM
• Tetos TTS 云服务支持
• @Yonsm 的 MiService
• @pjq 给了这个项目非常多的帮助
• @frostming 重构了一些代码，支持了持续会话功能

赞赏

谢谢就够了

xiaogpt 快速上手指南

xiaogpt 是一个让小米小爱音箱接入 ChatGPT、Kimi、通义千问、Gemini 等大语言模型的工具，无需 Root 即可实现智能对话。

1. 环境准备

• 操作系统：Linux, macOS, Windows (CMD/PowerShell)
• Python 版本：Python 3.8 及以上
• 硬件设备：支持的小米小爱音箱（需联网）
• 网络环境：能正常访问互联网或配置了代理（部分模型如 ChatGPT 需要）
• 账号信息：
  • 小米账号及密码
  • 对应大模型的 API Key（如 OpenAI, Moonshot, Aliyun 等）

2. 安装步骤

推荐使用 pip 进行安装：

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

提示：国内用户若下载缓慢，可添加国内镜像源： pip install -U --force-reinstall xiaogpt[locked] -i https://pypi.tuna.tsinghua.edu.cn/simple

获取设备 DID (必需)

在使用前，必须获取小爱音箱的设备 ID (MI_DID)。请根据系统选择对应命令：

第一步：安装依赖

pip install miservice_fork

第二步：设置账号环境变量

• Linux / Mac:

  export MI_USER=你的小米账号
  export MI_PASS=你的小米密码
  

• Windows CMD:

  set MI_USER=你的小米账号
  set MI_PASS=你的小米密码
  

• Windows PowerShell:

  $env:MI_USER="你的小米账号"
  $env:MI_PASS="你的小米密码"
  

第三步：获取并设置 DID 运行以下命令列出设备：

micli list

在输出结果中找到目标音箱的 did，然后设置环境变量：

• Linux / Mac: export MI_DID=xxx (xxx 为查到的 did)
• Windows CMD: set MI_DID=xxx
• Windows PowerShell: $env:MI_DID="xxx"

注意：如果获取 DID 报错，尝试切换手机或电脑的无线网络（如从 5G 切到 2.4G 或反之）。

3. 基本使用

最简单的启动方式

假设你的音箱型号为 LX06（型号通常位于音箱底部，或通过 micli mina 查看），并已准备好 OpenAI API Key。

1. 设置 OpenAI Key：

   export OPENAI_API_KEY=sk-xxxxxx
   

   (Windows 用户使用 set 或 $env: 设置)

2. 运行程序：

   xiaogpt --hardware LX06 --use_chatgpt_api
   

   或者直接使用账号密码登录（无需预先设置环境变量）：

   xiaogpt --hardware LX06 --account 你的小米账号 --password 你的小米密码 --use_chatgpt_api
   

使用方法

启动成功后，对着小爱音箱说出唤醒词（如“小爱同学”），然后说：

"帮我 [你的问题]"

例如：“帮我写一首关于春天的诗”。小爱将调用大模型生成回答并通过 TTS 朗读出来。

常用参数示例

• 静音小爱原生回复（仅播放 AI 回答）：

  xiaogpt --hardware LX06 --mute_xiaoai --use_chatgpt_api
  

• 使用 Kimi (Moonshot) 模型：

  xiaogpt --hardware LX06 --mute_xiaoai --use_moonshot_api --moonshot_api_key sk-xxxxxx
  

• 使用通义千问模型：

  xiaogpt --hardware LX06 --mute_xiaoai --use_qwen --qwen_key sk-xxxxxx
  

• 开启流式响应（更快出字）：

  xiaogpt --hardware LX06 --mute_xiaoai --stream --use_chatgpt_api
  

持续对话模式

在对话中直接对小爱说：

• "开始持续对话"：进入连续交互模式，无需每次都说“帮我”。
• "结束持续对话"：退出该模式。