whatisgithub

What is xiaogpt?

yihong0618/xiaogpt — explained in plain English

Analysis updated 2026-06-24

6,837PythonAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A Python tool that connects your Xiaomi smart speaker to ChatGPT and other AI services so you get smarter answers read aloud instead of the default assistant.

Mindmap

mindmap
  root((repo))
    What it does
      AI smart speaker
      ChatGPT integration
      Text to speech
    AI Backends
      ChatGPT
      Google Gemini
      Llama and others
    Features
      Streaming mode
      Continuous chat
      Docker support
    Setup
      Python 3.8 plus
      Xiaomi account
      API key needed
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

Replace your Xiaomi speaker's built-in AI with ChatGPT so your questions get smarter answers spoken aloud.

USE CASE 2

Connect the speaker to Google Gemini or another AI backend without any hardware changes.

USE CASE 3

Run in continuous-conversation mode to have a back-and-forth discussion with the AI through your speaker.

What is it built with?

PythonDockerYAML

How does it compare?

yihong0618/xiaogptxfangfang/macastgoogle-research/arxiv-latex-cleaner
Stars6,8376,8376,838
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencegeneralgeneralresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a Xiaomi account, device ID for your specific speaker model, and an API key from your chosen AI service.

So what is it?

Xiaogpt is a Python tool that connects a Xiaomi smart speaker to ChatGPT and a range of other AI chat services. Instead of only getting Xiaomi's built-in assistant responses, you can route your questions through a more capable AI and hear the answers read back to you through the speaker's text-to-speech system. The setup requires a Xiaomi AI speaker, a working internet connection, Python 3.8 or later, and an API key from whichever AI service you want to use. You log in with your Xiaomi account credentials, retrieve a device ID for your specific speaker model, then launch the tool from the command line with flags pointing to your hardware type and chosen AI backend. Once running, you phrase questions starting with a trigger word and the speaker relays the AI's answer aloud. The project supports a wide list of AI backends beyond ChatGPT, including Google Gemini, Moonshot, Alibaba's Tongyi Qianwen, Doubao, ChatGLM, Llama 3, and the 01 model from Lingyiwanwu. You can swap between them by passing different flags on startup. For text-to-speech output there are several options as well: the default built-in speaker voice, Microsoft Edge TTS, OpenAI TTS, Azure TTS, or Fish Audio. There are practical options to smooth out the experience. You can mute the Xiaomi speaker's own default reply so it does not talk over the AI's answer. A streaming mode starts playing the response sooner rather than waiting for the full answer to arrive. A continuous-conversation mode keeps context across multiple exchanges. If you prefer not to use command-line flags every time, you can put all your settings into a YAML or JSON config file and point the tool at it on startup. A Docker image is available if you do not want to install dependencies directly. The project is aimed at people who own a Xiaomi speaker and want a more capable AI assistant without buying new hardware.

Copy-paste prompts

Prompt 1
Walk me through setting up xiaogpt on my Mac to connect my Xiaomi AI speaker to ChatGPT using my OpenAI API key.
Prompt 2
How do I configure xiaogpt to use streaming mode so the Xiaomi speaker starts talking sooner rather than waiting for the full answer?
Prompt 3
Show me the YAML config file format for xiaogpt so I can set up Google Gemini as my AI backend without using command-line flags every time.
Prompt 4
How do I use the Docker image for xiaogpt so I do not need to install Python dependencies directly on my machine?

Frequently asked questions

What is xiaogpt?

A Python tool that connects your Xiaomi smart speaker to ChatGPT and other AI services so you get smarter answers read aloud instead of the default assistant.

What language is xiaogpt written in?

Mainly Python. The stack also includes Python, Docker, YAML.

How hard is xiaogpt to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is xiaogpt for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.