Skip to content
Hard Hub

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

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

Nearby projects