python-miio
Python library for interfacing with Xiaomi smart appliances
Decision gist · record as of 2026-08-14
Yes, if you own Xiaomi smart devices and want programmatic or CLI control without relying on cloud services or proprietary apps. The library is stable, actively maintained, and widely used. The copyleft GPL-3.0-only license is a consideration if you plan to distribute derivative work. No known security vulnerabilities as of the query date.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a valid device token and network connectivity to the target Xiaomi device.
- Low install friction with a pure Python wheel.
- Active maintenance as of 2026-07-25 with 4285 repository stars.
License · maintenance · safety
GPL-3.0-only (copyleft) — Licensed under GPL-3.0-only (copyleft). Any derivative work or bundled distribution must also be open-source under compatible terms.
last release 2022-07-18 (1488 days) · last repo commit 2026-07-25 · 4,285 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 329,400 downloads/mo, #7,546 on PyPI
Alternatives
Verify before relying
pip install python-miio
from miio import RoborockVacuum
vac = RoborockVacuum("", "")
vac.start()- Whether all 15 runtime dependencies are truly required for basic operation or if some are optional for specific device types.
- Current maintenance status beyond the last commit date—whether active development continues or the project is in maintenance-only mode.
- Specific IP address and token format requirements for device connection.
What it is and what it does
python-miio is a Python library and command-line tool for communicating with Xiaomi smart home devices using their proprietary miIO and MIoT protocols. It provides both a programmatic API (via classes like RoborockVacuum and Device) and a CLI tool (miiocli) for discovering devices, querying their status, and sending control commands. The library abstracts away protocol details and handles device model detection automatically.
The package supports a wide range of Xiaomi and compatible devices—robot vacuums, air purifiers, fans, smart plugs, lights, humidifiers, and others—each exposed through a dedicated module. It is actively used by Home Assistant for official device integration. Installation is straightforward with low friction, though operation requires obtaining a device token and network access to the target device.
Use it for
- Control a Xiaomi robot vacuum from Python or the command line without proprietary apps.
- Automate Xiaomi smart home devices in a home automation system.
- Query device status and execute device-specific commands via miiocli.
- Build custom integrations for unsupported Xiaomi devices by extending the Device or MiotDevice base classes.
- Monitor and control air purifiers, humidifiers, and environmental devices on a local network.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own Xiaomi smart devices and want programmatic or CLI control without relying on cloud services or proprietary apps.
The library is stable, actively maintained, and widely used. The copyleft GPL-3.0-only license is a consideration if you plan to distribute derivative work. No known security vulnerabilities as of the query date.
Install
python-miio on PyPI
Before you install
Low install friction with a pure Python wheel. Active maintenance as of 2026-07-25 with 4285 repository stars. Supports Python 3.7 through 3.10.
Requires a valid device token and network connectivity to the target Xiaomi device.
License in practice
Licensed under GPL-3.0-only (copyleft). Any derivative work or bundled distribution must also be open-source under compatible terms.
Quickstart
pip install python-miio
from miio import RoborockVacuum
vac = RoborockVacuum("", "")
vac.start()Verify before relying
- Whether all 15 runtime dependencies are truly required for basic operation or if some are optional for specific device types.
- Current maintenance status beyond the last commit date—whether active development continues or the project is in maintenance-only mode.
- Specific IP address and token format requirements for device connection.
Package facts
| License | GPL-3.0-only copyleft |
| Python support | Supports the current Python release >=3.7,<4.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 15 packagesPyYAMLandroid_backupappdirsattrsclickconstructcronitercryptographydefusedxmlimportlib_metadatamicloudnetifacespytztqdmzeroconf |
| Maintenance | Actively maintained 1,488 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 329,400 / month, #7,546 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: End Users/DesktopLicense :: OSI Approved :: GNU General Public License v3 (GPLv3)Operating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Home AutomationTopic :: System :: Hardware |
Evidence: python_miio-0.5.12-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “xiaomi smart home control”
- python-miioPython library and CLI tool for controlling Xiaomi smart devices…
- xiaomi-bleManages Xiaomi BLE (Bluetooth Low Energy) devices by providing a…
- zigpy-znpAdds support for Texas Instruments ZNP Zigbee radio modules to the…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also nmcli · xiaomi-ble · broadlink · roombapy · micloud · tinytuya · python-roborock · pymiele · wiim · pywemo