在这个数字化的世界里，家已不仅仅是一个居住的地方，而是我们数字生活的延伸。

MiGPT 通过将小爱音箱、米家智能设备，与 ChatGPT 的理解能力完美融合，让你的智能家居更懂你。

MiGPT 不仅仅是关于设备自动化，而是关于：打造一个懂你、有温度、与你共同进化的家。

未来，你的每个智能家居设备，从灯泡、插座，到扫地机器人、电视等，

都可以作为一个个独立的智能体 (Agent)，更智能、更贴心的响应你的指令。

这些独立的智能体，也可以彼此感知，彼此配合，构成一个更强大的协作网络。

而小爱音箱就像是你的智能家居专属管家，全心全意为你服务，释放智能家居真正的潜力。

• 🎓 LLM 回答。想象一下，你的小爱音箱变身聊天高手，可以使用 ChatGPT 等大模型来回答你的问题。
• 🎭 角色扮演。一秒调教小爱，无论是成为你的完美伴侣，还是那个能听你倾诉心事的贴心闺蜜，都不在话下。
• 💬 流式响应。爱情来得太快就像龙卷风，而你的小爱音箱也是，对你的爱意秒回，爱你不会让你等太久。
• 🧠 长短期记忆。小爱音箱现在能记住你们之间的每一次对话，越聊越默契，就像是你身边的老朋友。
• 🔊 自定义 TTS。厌倦了小爱同学的语音？帮你解锁「豆包」同款音色，就像真人在回你的消息。
• 🤖️ 智能家居 Agent。心情不好？小爱立刻懂你，自动帮你播放喜欢的音乐，调节灯光，逗你开心。TODO

MiGPT 有两种启动方式: Docker 和 Node.js。

对于电脑小白或者不想自己配置代码运行环境（Node）的同学，可以使用 Docker 启动方式。

请先按照「配置参数」章节，配置好你的 .env 和 .migpt.js 文件，然后使用以下命令启动 docker：

docker run -d  --env-file $(pwd)/.env \
    -v $(pwd)/.migpt.js:/app/.migpt.js \
    idootop/mi-gpt:latest

如果你是一名前端 (Node) 开发者，也可以通过 NPM 安装 mi-gpt 启动 MiGPT。

npm install mi-gpt # 安装依赖

然后，创建并启动 MiGPT 实例。初始化参数请看下面的「配置参数」章节。

import { MiGPT } from "mi-gpt";

async function main() {
  const client = MiGPT.create({
    speaker: {
      userId: "987654321", // 注意：不是手机号或邮箱，请在「个人信息」-「小米 ID」查看
      password: "123456", // 账号密码
      did: "小爱音箱Pro", // 小爱音箱 ID 或在米家中设置的名称
    },
  });
  await client.start();
}

main();

重命名本项目根目录下的 .migpt.example.js 文件为 .migpt.js。

然后，将里面的配置参数修改成你自己的，参数含义如下：

重命名本项目根目录下的 .env.example 文件为 .env。

然后，将里面的环境变量修改成你自己的，参数含义如下：

Q：支持哪些型号的小爱音箱？

大部分型号的小爱音箱都支持，推荐小爱音箱 Pro（完美运行）。部分机型的 MioT 接口开放能力并不完整，比如小米音箱 Play 增强版（L05C），将会导致 MiGPT 部分功能异常，相关 issue。

Q：除了 OpenAI 还支持哪些模型，如何设置？

理论上兼容 OpenAI SDK 的模型都支持，只需修改环境变量即可接入到 MiGPT。

比如：通义千问、零一万物、Moonshot、DeepSeek 等，以 Moonshot 为例：

OPENAI_BASE_URL=https://api.moonshot.cn/v1
OPENAI_MODEL=moonshot-v1-8k
OPENAI_API_KEY=$MOONSHOT_API_KEY

Q：提示登录小米账号失败，无法正常启动

1. 账号密码不正确：小米 ID 并非手机号或邮箱，请在「个人信息」-「小米 ID」查看。
2. 网络异常：如果你的账号密码确认配置正确，但依旧提示登录失败，大概率是因为网络异常或当前 IP 小米账号登录被风控（打开小米账号主页看看能否登录成功），可以尝试切换代理或等待一段时间（2-24 小时）后再试。issue#10

Q：小爱音箱收到消息后，没有调用 AI 进行回复

MiGPT 收到消息默认不会调用 AI 进行回复，只会回复以唤醒词（callAIKeywords）开头的消息，比如：“请问 xxx”、“你 xxx” 等，你也可以自定义唤醒词列表。

Q：小爱音箱没有播放 AI 的回答，但控制台有打印 AI 的回复

不同型号的小爱音箱 TTS 指令不同: https://github.com/idootop/mi-gpt/issues/5

请到 https://home.miot-spec.com 查询具体指令，并修改配置文件中的 ttsCommand 参数。

Q：小爱音箱没有读完整个句子，总是戛然而止

部分型号的小爱音箱不支持通过 Mina 获取设备播放状态，只能通过 MiOT 指令查询。

请到 https://home.miot-spec.com 查询具体指令，并修改配置文件中的 playingCommand 参数。

如果修改参数后问题仍然存在，说明你的设备不支持通过开放接口查询播放状态（比如：小米音箱 Play 增强版），此问题无解。建议更换其他型号的小爱音箱（推荐小爱音箱 Pro），相关 issue。

或者你也可以关闭 .migpt.js 配置文件中的流式响应（streamResponse）选项，确保小爱能够回复完整的句子。不过需要注意的是，关闭流式响应后，唤醒模式等功能将失效。

Q：怎样使用豆包的音色

此功能需要豆包 TTS 接口支持，本项目暂不对外提供此服务。

Q：我还有其他问题

请在此处提交 issue 反馈，并提供详细的问题描述和相关错误截图。

本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。 本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。 作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。 使用本项目即表示您已阅读并同意本免责声明的全部内容。

• https://github.com/yihong0618/xiaogpt
• https://github.com/inu1255/mi-service
• https://github.com/Yonsm/MiService