rytilahti/python-miio

Что это?

Ключевые возможности

• 01Управление устройствами miIO и MIoT по локальной сети с помощью IP-адреса и токена.
• 02Универсальная интеграция MIoT получает статусы, настройки и действия из файлов спецификации устройств.
• 03Отдельные модули поддерживают множество роботов-пылесосов, очистителей воздуха, вентиляторов, увлажнителей, ламп и розеток Xiaomi.
• 04Команда miiocli позволяет получать сведения об устройстве и его статусе, менять настройки и вызывать действия.
• 05Получение токенов устройств из облачной учётной записи Xiaomi с помощью команды cloud.
• 06В комплект входят симуляторы miIO и MIoT для тестирования без оборудования.

Сценарии использования

• Написание скриптов и автоматизация устройств Xiaomi на Python.
• Создание собственной интеграции или панели управления бытовыми устройствами Xiaomi для умного дома.
• Тестирование клиента miIO или MIoT без физического устройства.
• Получение статуса устройства и изменение настроек из терминала.

Быстрый старт

1. 1

   Установите библиотеку из PyPI

   pip install python-miio
2. 2

   Узнайте IP-адрес и токен устройства (например, с помощью команды cloud)

   miiocli cloud
3. 3

   Отправьте запрос устройству, чтобы узнать его модель и команду управления

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

Что важно знать

• !Для поддержки современных устройств MIoT до выхода версии 0.6.0 требуется версия из git или предварительный выпуск.
• !Для управления устройствами необходимо знать IP-адрес и токен каждого устройства.
• !Это добровольный проект сообщества, не связанный с производителями устройств.
• !Распространяется по лицензии GPL-3.0 — лицензии с авторским левом.

Темы

Частые вопросы

Что такое python-miio?

Библиотека Python и CLI-инструмент miiocli для управления устройствами умного дома Xiaomi по протоколам miIO и MIoT. python-miio — библиотека Python и сопровождающий её CLI-инструмент miiocli для управления бытовыми устройствами умного дома Xiaomi. Библиотека поддерживает протоколы Xiaomi miIO и MIoT, поэтому после того, как вы узнаете IP-адрес и токен устройства, его можно опрашивать и контролировать по локальной сети.

python-miio можно использовать бесплатно? Какая у него лицензия?

python-miio распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

python-miio всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в python-miio — 25 июл. 2026 г..

Для чего можно использовать python-miio?

Написание скриптов и автоматизация устройств Xiaomi на Python. Создание собственной интеграции или панели управления бытовыми устройствами Xiaomi для умного дома. Тестирование клиента miIO или MIoT без физического устройства. Получение статуса устройства и изменение настроек из терминала.

Как установить python-miio?

Установите библиотеку из PyPI: pip install python-miio Узнайте IP-адрес и токен устройства (например, с помощью команды cloud): miiocli cloud Отправьте запрос устройству, чтобы узнать его модель и команду управления: miiocli device --ip <ip> --token <token> info

Где скачать python-miio?

Исходный код и инструкции по установке — на GitHub: https://github.com/rytilahti/python-miio