python-xiaomi-miwifi

Async Python client for Xiaomi / MiWiFi routers over their LuCI HTTP API. Built to power the ha-xiaomi-miwifi Home Assistant integration.

Features

• 🔐 Token login with the MiWiFi sha1(nonce + sha1(password + key)) signing scheme
• 📊 Aggregated status: WAN, throughput, client counts per band, firmware, mesh topology
• 🕸️ Mesh-aware: enumerates gateway + leaf nodes
• 🛠️ Controls: reboot, per-radio enable/disable, DHCP reservation add/remove
• ⚡ Fully async (aiohttp), typed (py.typed), zero-config session management

Installation

pip install python-xiaomi-miwifi

Quickstart

import asyncio
from xiaomi_miwifi import MiWiFiClient


async def main() -> None:
    async with MiWiFiClient("192.168.31.1", password="your-password") as client:
        status = await client.async_get_status()
        print(status.model, status.client_count, status.wan_ip)
        for node in status.mesh_nodes:
            print("mesh:", node.name, node.model, node.ip)


asyncio.run(main())

Supported routers

Have a different Xiaomi router? Open an issue with the output of api/misystem/newstatus and we'll add it.

API overview

Development

uv venv && uv pip install -e ".[test]"
pytest
ruff check .

License

MIT © Hudson Brendon