# aholstenson/miio

Control Mi Home devices, such as Mi Robot Vacuums, Mi Air Purifiers, Mi Smart Home Gateway (Aqara) and more

Repository: https://github.com/aholstenson/miio
Canonical: https://ross.abutalabs.com/products/miio
Language: JavaScript
License: MIT
License Family: permissive
Topics: miio-protocol, home-automation, mi-home, xiaomi, aqara, yeelight, mijia, miio
Last push: 2021-09-02T17:47:22+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3454, "days_push": 1826, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1906, forks 349 (observed 2026-08-28T04:05:52.509058+00:00)

## What it is
A JavaScript library and CLI for controlling Xiaomi Mi Home devices that speak the miIO protocol, such as robot vacuums, air purifiers, smart plugs, and Yeelights. It maps device models to generic types with promise-based APIs and supports automatic token resolution.

## Use cases
- control xiaomi robot vacuum from node.js
- discover and control mi home devices on local network
- toggle power on mi smart plug programmatically
- integrate aqara sensors with home automation
- control yeelight bulbs without cloud
- get miio device token via command line

## When to choose
- you want local network control of miIO-compatible Xiaomi devices from JavaScript
- you need a CLI to discover devices and retrieve tokens
- you're building a home automation integration for Mi Ecosystem devices

## When to avoid
- you need cloud-based control or the official Mi Home app features
- your device is not miIO-protocol compatible
- you need actively maintained software with recent updates

## Facets
- artifact type: library
- maturity: maintenance
- function: sdk, cli, iot
- domain: iot, developer-tools
- platform: cli, cross-platform
- tags: miio-protocol, xiaomi, mi-home, smart-home, aqara, yeelight, home-automation, automation, nodejs

## Member repositories
- aholstenson/miio (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:52.509058+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:39.916033+00:00, confidence not recorded.
  - readme: https://github.com/aholstenson/miio (fetched 2026-08-28T04:05:52.509058+00:00, sha 41553912c1c6)
  - registry_npm: https://registry.npmjs.org/miio (fetched 2026-08-29T10:50:53.045835+00:00, sha e1e0f6ade7cd)
- Data as of 2026-08-30T08:39:29.467469+00:00.