Skip to content
Get packs

MiGPT

Connects a Xiaomi (Xiaoai) smart speaker to ChatGPT or Doubao for AI voice replies. Archived, no longer mainta

GitHub Download v4.2.0
Stars
12.5k
Forks
1.8k
Licence
MIT
Language
TypeScript
Last update
7 months ago
Type
App

This repository is archived and no longer maintained.

What it is

MiGPT is a tool that links a Xiaomi Xiaoai speaker to a large language model such as ChatGPT or Doubao, so you can ask the speaker questions and get AI-generated answers. It can also use custom voices and remember past conversations. The project's README says it is no longer maintained and has been archived.

  • Ask the speaker general knowledge questions and receive answers from a connected LLM
  • Chat with the speaker in a custom roleplay persona
  • Use a Doubao-style voice for the speaker's spoken replies
  • Run MiGPT in a Docker container on a home computer or server

Great for

  • Owners of a Xiaoai speaker (Pro is recommended in the README) who want more conversational answers
  • People comfortable editing a .env config file or running a Docker command
  • Developers who want to embed MiGPT in a Node.js project via npm
  • Hobbyists who want to experiment with custom TTS voices and persona roleplay

Not ideal for

  • Owners of Xiaodu, Tmall Genie or HomePod speakers, since the README says these are not supported and not planned
  • Anyone who needs ongoing bug fixes or updates, because the project is archived and unmaintained
  • Users who want guaranteed smart-home control, since the README's smart-home agent feature is struck through and not presented as working

How to get it

  1. 1

    Run with Docker

    You'll need: Docker (for the Docker method) · Node.js (for the npm method; version not stated in the README excerpt) · A compatible Xiaomi Xiaoai speaker and a Xiaomi account

    Run with Docker (after configuring .env and .migpt.js)

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

    Install the npm package

    npm install mi-gpt
  2. 2

    Run it

    • Check the compatibility doc to confirm your speaker model is supported
    • Create the .env and .migpt.js settings files as described in the settings doc
    • Start MiGPT with the Docker command, or create a MiGPT instance in Node.js
    • Wake the speaker by saying 小爱同学，请 followed by your question
  3. 3

    Get the most out of it

    • Read the settings doc (docs/settings.md) to configure the LLM provider and speaker credentials
    • Use the third-party TTS doc (docs/tts.md) to change the voice
    • Check the FAQ (docs/faq.md) when you hit common login or setup problems
    • Look at the linked forks such as MiGPT GUI if you prefer a graphical setup

Downloads

Source code (.zip)main branch · straight from GitHubRelease v4.2.0Release notes and source

Strengths

  • Clear two-path setup: Docker for less technical users, or npm for Node developers
  • Open source under the MIT license, so it can be forked or modified freely
  • Large community interest, with about 12,500 GitHub stars and linked video tutorials

Trade-offs

  • Archived: the README states it is no longer maintained or supported, so breakage from upstream changes is unlikely to be fixed
  • Works only with supported Xiaoai speaker models; the README points to a separate compatibility doc for details
  • Requires a Xiaomi account and credentials, and the README's own setup notes warn about account login issues

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.