Smart Home & IoT
python-roborock
Python-roborock/python-roborock
Python library for Roborock vacuums via the reverse-engineered cloud and local APIs
What it is
python-roborock is a Python library, plus a small command line tool, for talking to Roborock vacuums directly from code: through Roborock's own cloud account, or over the local network, without going through the vendor's app.
How it works
After a one time login with a Roborock account email and a code sent to it, it discovers the devices on that account and exposes each one's status, consumables and cleaning commands as typed properties grouped by the device's protocol generation (most vacuums under one set of properties, wet or dry cleaning devices like mops under another), so another program, such as a smart home integration or a script, can read and control the robot the same way the app does.
Sources
- python-roborock README
Guide· Python-roborock· Read on Oct 26, 2026
Checked on Oct 26, 2026
Facts
- Stars
- ★ 243
- Language
- Python
- License
- Apache-2.0
- Last push
- Oct 22, 2026· Active
Who maintains it
Used for
- Drive it from your computerRoborock robot vacuums
Nearby projects
- koreader/koreaderEbook reader app for Kindle, Kobo, PocketBook and reMarkableActive★ 30.6K
- Koenkk/zigbee2mqttZigbee to MQTT bridge, removes the need for proprietary vendor hubsActive★ 15.8K
- Hypfer/ValetudoCloud-free web UI and firmware replacement for robot vacuums (Roborock, Dreame)Active★ 9.8K
- merbanan/rtl_433Decode radio transmissions from 200+ devices on ISM bandsActive★ 7.9K
- al-one/hass-xiaomi-miotHome Assistant integration for Xiaomi MIoT devices via the miot spec protocolActive★ 6.2K
- PiotrMachowski/Xiaomi-cloud-tokens-extractorThis tool retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE devices.Active★ 4.9K
- rytilahti/python-miioPython library & console tool for controlling Xiaomi smart appliancesActive★ 4.3K
- 1technophile/OpenMQTTGatewayGateway firmware bridging RF, IR, BLE and LoRa devices to MQTTActive★ 4.1K