rytilahti/python-miio

O que é?

Recursos principais

• 01Controla dispositivos miIO e MIoT pela rede local usando o endereço IP e o token.
• 02A integração genérica MIoT expõe o status, as configurações e as ações definidos nos arquivos de especificação dos dispositivos.
• 03Módulos dedicados oferecem suporte a vários robôs aspiradores, purificadores de ar, ventiladores, umidificadores, lâmpadas e tomadas Xiaomi.
• 04O comando miiocli permite consultar informações e status do dispositivo, alterar configurações e chamar ações.
• 05Obtém tokens dos dispositivos por meio de uma conta Xiaomi na nuvem usando o comando cloud.
• 06Inclui simuladores de miIO e MIoT para testar sem hardware.

Casos de uso

• Criar scripts ou automatizar dispositivos Xiaomi com um programa Python.
• Desenvolver uma integração ou um painel personalizado de casa inteligente para aparelhos Xiaomi.
• Testar um cliente miIO ou MIoT sem ter o dispositivo físico.
• Consultar o status do dispositivo e alterar configurações pelo terminal.

Início rápido

1. 1

   Instale a biblioteca pelo PyPI

   pip install python-miio
2. 2

   Obtenha o endereço IP e o token do seu dispositivo (por exemplo, usando o comando cloud)

   miiocli cloud
3. 3

   Consulte o dispositivo para ver o modelo e o comando para controlá-lo

   miiocli device --ip <ip> --token <token> info

Antes de usar

• !O suporte a dispositivos MIoT modernos exige a versão do git ou uma versão de pré-lançamento até a versão 0.6.0 ser lançada.
• !Para controlar os dispositivos, é necessário saber o endereço IP e o token de cada um.
• !Este é um projeto comunitário voluntário, sem afiliação com os fabricantes dos dispositivos.
• !Licenciado sob a GPL-3.0, uma licença copyleft.

Tópicos

Perguntas frequentes

O que é python-miio?

Biblioteca Python e ferramenta de linha de comando miiocli para controlar dispositivos Xiaomi de casa inteligente pelos protocolos miIO e MIoT. python-miio é uma biblioteca Python acompanhada da ferramenta de linha de comando miiocli para controlar aparelhos Xiaomi de casa inteligente. Ela se comunica pelos protocolos miIO e MIoT da Xiaomi, permitindo consultar e controlar um dispositivo pela rede local quando você tem o endereço IP e o token.

python-miio é gratuito? Qual é a licença?

python-miio é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

python-miio ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de python-miio foi em 25 de jul. de 2026.

Para que posso usar python-miio?

Criar scripts ou automatizar dispositivos Xiaomi com um programa Python. Desenvolver uma integração ou um painel personalizado de casa inteligente para aparelhos Xiaomi. Testar um cliente miIO ou MIoT sem ter o dispositivo físico. Consultar o status do dispositivo e alterar configurações pelo terminal.

Como instalar python-miio?

Instale a biblioteca pelo PyPI: pip install python-miio Obtenha o endereço IP e o token do seu dispositivo (por exemplo, usando o comando cloud): miiocli cloud Consulte o dispositivo para ver o modelo e o comando para controlá-lo: miiocli device --ip <ip> --token <token> info

Onde consigo python-miio?

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