xiaomi-ble
Manage Xiaomi BLE devices
Decision gist · record as of 2026-08-14
Yes, if you need to integrate Xiaomi BLE devices into a Python application and accept Pre-Alpha stability. The library is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. However, verify that your target Xiaomi devices are supported and be prepared for API changes as the library matures.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a system with Bluetooth hardware and appropriate OS-level Bluetooth drivers (Linux, macOS, or Windows with BLE support).
- Low friction installation with a pure-Python wheel.
- Active maintenance (last commit 2026-08-10) and recent release (25 days old).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and note any modifications.
last release 2026-07-20 (25 days) · last repo commit 2026-08-10 · 70 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 80,704 downloads/mo, #14,275 on PyPI
Alternatives
Verify before relying
pip install xiaomi-ble
import asyncio
from xiaomi_ble import XiaomiBluetoothDeviceData
# Requires bleak for BLE scanning and connection
await XiaomiBluetoothDeviceData.discover()- Which specific Xiaomi device models are supported by this version
- Whether the library handles device pairing or assumes pre-paired devices
- Real-world reliability and latency characteristics for typical Xiaomi devices
- Whether decryption of Xiaomi cloud keys is automatic or requires manual setup
What it is and what it does
xiaomi-ble is a Python library for communicating with Xiaomi smart devices over Bluetooth Low Energy. It wraps the complexity of BLE protocol handling—using bleak for cross-platform Bluetooth access and related libraries for device data parsing and cryptography—into a simpler interface for discovering and reading sensor data from Xiaomi devices.
The library is in Pre-Alpha development, meaning its API and feature set are still evolving. It depends on a substantial stack of Bluetooth and cryptographic libraries (aiohttp, bleak, bleak-retry-connector, bluetooth-data-tools, bluetooth-sensor-state-data, cryptography, home-assistant-bluetooth, orjson, pycryptodomex, sensor-state-data) to handle the low-level work. It targets Python 3.11 and later and is actively maintained, with recent releases and ongoing commits.
Use it for
- Read sensor data (temperature, humidity, battery) from Xiaomi smart home devices in a home automation setup
- Discover and enumerate Xiaomi BLE devices on a local network for device inventory or pairing workflows
- Integrate Xiaomi device telemetry into a Home Assistant or custom IoT dashboard
- Decrypt and parse Xiaomi device payloads for research or reverse-engineering Xiaomi BLE protocols
- Monitor Xiaomi device state changes asynchronously in a long-running service or daemon
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to integrate Xiaomi BLE devices into a Python application and accept Pre-Alpha stability.
The library is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. However, verify that your target Xiaomi devices are supported and be prepared for API changes as the library matures.
Install
xiaomi-ble on PyPI
Before you install
Low friction installation with a pure-Python wheel. Active maintenance (last commit 2026-08-10) and recent release (25 days old). Pre-Alpha status signals the library is still stabilizing; expect API changes or incomplete feature coverage.
Requires a system with Bluetooth hardware and appropriate OS-level Bluetooth drivers (Linux, macOS, or Windows with BLE support).
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and note any modifications.
Quickstart
pip install xiaomi-ble
import asyncio
from xiaomi_ble import XiaomiBluetoothDeviceData
# Requires bleak for BLE scanning and connection
await XiaomiBluetoothDeviceData.discover()Verify before relying
- Which specific Xiaomi device models are supported by this version
- Whether the library handles device pairing or assumes pre-paired devices
- Real-world reliability and latency characteristics for typical Xiaomi devices
- Whether decryption of Xiaomi cloud keys is automatic or requires manual setup
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4.0,>=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesaiohttpbleakbleak-retry-connectorbluetooth-data-toolsbluetooth-sensor-state-datacryptographyhome-assistant-bluetoothorjsonpycryptodomexsensor-state-data |
| Maintenance | Actively maintained 25 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 80,704 / month, #14,275 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 2 - Pre-AlphaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Libraries |
Evidence: xiaomi_ble-1.16.0-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 bluetooth device control”
- xiaomi-bleManages Xiaomi BLE (Bluetooth Low Energy) devices by providing a…
- python-miioPython library and CLI tool for controlling Xiaomi smart devices…
- micloudLogs into Xiaomi cloud accounts and retrieves device information and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also bumble · govee-ble · micloud · python-miio · uart-devices · airthings-ble · simplepyble · yalexs-ble · kegtron-ble · aiobmsble