gitwtfhub

wtf is mi-gpt?

idootop/mi-gpt — explained in plain English

Analysis updated 2026-06-24

12,412TypeScriptAudience · vibe coderComplexity · 3/5Setup · moderate

TL;DR

A tool that upgrades Xiaomi Xiao Ai smart speakers to use ChatGPT or other AI models, enabling richer conversations, a custom persona, long-term memory, and a swappable voice, runs via Docker or Node.js.

Mindmap

mindmap
  root((MiGPT))
    What it does
      AI-powered speaker
      Custom persona
      Long-term memory
    Tech Stack
      TypeScript
      Node.js
      Docker
    Requirements
      Xiaomi account
      Xiao Ai speaker
      OpenAI API key
    Audience
      Smart home fans
      Xiaomi users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Route your Xiao Ai speaker's questions through ChatGPT to get smarter, more conversational answers

REASON 2

Give your Xiaomi speaker a custom personality that responds in a specific character or conversational style

REASON 3

Enable your speaker to remember past conversations over time rather than starting fresh each session

REASON 4

Connect a third-party text-to-speech service to change the voice used for AI responses

What's in the stack?

TypeScriptNode.jsDocker

How it stacks up

idootop/mi-gptmodelcontextprotocol/typescript-sdktheatre-js/theatre
Stars12,41212,42212,425
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Xiaomi account, a compatible Xiao Ai speaker model, and an API key for an AI service such as OpenAI.

Wtf does this do

MiGPT is a tool that connects Xiaomi smart speakers (known in China as Xiao Ai speakers) to AI language models, turning them into more capable voice assistants. The default Xiao Ai assistant is relatively limited in what it can answer. By running MiGPT alongside your speaker, you can route questions through a large language model like ChatGPT or other compatible APIs, getting much richer and more conversational responses back through the speaker's voice. The project is no longer actively maintained, as noted prominently at the top of the README. The author has also released a related successor called Open-XiaoAI for users of the Xiao Ai speaker Pro model, which offers additional features like custom wake words and continuous conversation. MiGPT remains available for reference and use as-is. Beyond basic AI question answering, MiGPT supports a few other features. You can give the speaker a custom persona so it responds in a particular character or conversational style. It also supports long-term memory of past conversations, meaning it can recall earlier exchanges over time rather than treating each session as a fresh start. The voice used for responses can be customized by connecting a third-party text-to-speech service, with support for a voice style from a Chinese AI assistant called Doubao as one documented option. Setup requires a Xiaomi account, a compatible Xiao Ai speaker, and an API key for an AI service like OpenAI. You configure the connection in a small configuration file and then run MiGPT either through Docker or Node.js. The Docker path is simpler and does not require any coding knowledge. The Node.js path is intended for developers who want to integrate MiGPT into their own applications as a library. The repository is primarily in Chinese, with the README, documentation files, and community materials all written for a Chinese-speaking audience familiar with Xiaomi's home device ecosystem.

Yoink these prompts

Prompt 1
Set up MiGPT using Docker to connect my Xiaomi Xiao Ai speaker to the OpenAI API, walk me through the config file step by step
Prompt 2
How do I give my MiGPT speaker a custom persona so it always responds in the style of a specific character?
Prompt 3
Configure MiGPT to use a Chinese AI model instead of OpenAI, what API endpoint and key settings do I need to change?
Prompt 4
How does MiGPT's long-term memory feature work and how do I enable it so my speaker remembers past conversations?
Prompt 5
Install MiGPT via Node.js and integrate it as a library into my own TypeScript smart home project

Frequently asked questions

wtf is mi-gpt?

A tool that upgrades Xiaomi Xiao Ai smart speakers to use ChatGPT or other AI models, enabling richer conversations, a custom persona, long-term memory, and a swappable voice, runs via Docker or Node.js.

What language is mi-gpt written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

How hard is mi-gpt to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mi-gpt for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.