yihong0618/xiaogpt

O que é?

Recursos principais

• 01Encaminha perguntas por voz do Xiaomi AI Speaker ao ChatGPT ou a outros LLMs.
• 02Reproduz as respostas do modelo pelo TTS do alto-falante ou por serviços de TTS de terceiros.
• 03Oferece suporte a respostas em streaming e ao modo de conversa contínua.
• 04Permite configurar o projeto por flags de CLI ou por um arquivo de configuração YAML/JSON.
• 05Disponibiliza uma imagem Docker para implantação.

Casos de uso

• Adicionar um assistente de IA conversacional a um alto-falante Xiaomi em casa.
• Experimentar diferentes backends de LLM por meio de uma interface de voz.
• Personalizar a voz do alto-falante com o provedor de TTS preferido.

Início rápido

1. 1

   Instale o xiaogpt pelo PyPI

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

   Encontre o DID do seu alto-falante com o MiService (configure MI_USER e MI_PASS primeiro)

   miservice list
3. 3

   Configure sua chave de API da OpenAI

   export OPENAI_API_KEY=${your_api_key}
4. 4

   Execute o xiaogpt com o modelo do seu alto-falante e a API do ChatGPT

   xiaogpt --hardware LX06 --use_chatgpt_api

Antes de usar

• !É necessário ter um Xiaomi AI Speaker e uma conta Xiaomi.
• !Para usar o ChatGPT ou outros modelos, é necessária uma chave de API de LLM, que geralmente é paga.
• !É necessário usar o Python 3.12 a 3.14.

Tópicos

Perguntas frequentes

O que é xiaogpt?

Transforma um Xiaomi AI Speaker em uma interface de voz para ChatGPT e outros LLMs, encaminhando perguntas após a palavra de ativação a um modelo e reproduzindo as respostas em voz alta. xiaogpt é uma ferramenta em Python que conecta um Xiaomi AI Speaker a modelos de linguagem grandes. As perguntas feitas ao alto-falante após uma frase de ativação, como "帮我", são enviadas ao modelo configurado, e a resposta é reproduzida pelo recurso de síntese de fala do dispositivo.

xiaogpt é gratuito? Qual é a licença?

xiaogpt é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

xiaogpt ainda é mantido?

Manutenção ativa. O último commit de xiaogpt foi em 7 de out. de 2026.

Para que posso usar xiaogpt?

Adicionar um assistente de IA conversacional a um alto-falante Xiaomi em casa. Experimentar diferentes backends de LLM por meio de uma interface de voz. Personalizar a voz do alto-falante com o provedor de TTS preferido.

Como instalar xiaogpt?

Instale o xiaogpt pelo PyPI: pip install -U --force-reinstall xiaogpt[locked] Encontre o DID do seu alto-falante com o MiService (configure MI_USER e MI_PASS primeiro): miservice list Configure sua chave de API da OpenAI: export OPENAI_API_KEY=${your_api_key} Execute o xiaogpt com o modelo do seu alto-falante e a API do ChatGPT: xiaogpt --hardware LX06 --use_chatgpt_api

Onde consigo xiaogpt?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yihong0618/xiaogpt