Robot vacuums · Roborock
Roborock robot vacuums
One of the most studied brands. Most models can be driven over your home network after one cloud login; some can drop the cloud entirely.
What it can become
What owners already do with it, easiest first.
Drive it from your computer
Start, pause, clean one room, send it to a spot without cleaning, read its status. You log in to your Roborock account once to get the keys, then commands go over your network.
See its live map in Home Assistant
Home Assistant ships a Roborock integration; a community card adds the live map with rooms and the robot's path.
Keep it working without internet
A small server on your network plays the part of Roborock's cloud, so the robot keeps working when the internet or the vendor goes away.
Replace its software with Valetudo
Root the robot and run Valetudo: a local web app, no account, no cloud. Only some models can be rooted; check the supported list for yours first.
Hand it to your agent
A recipe any AI agent can follow to drive it for you, written and run on a real device.
roborock-v1-vacuumRun by its author, not yet reproducedDrive a Roborock robot vacuum that speaks the V1 protocol (Q8 Max, S7, S8 and kin) with python-roborock - read its status and rooms, send it to a point without cleaning, clean a room, remote-control it, bring it back to its dock.
- Local control
- One cloud login, once
- It moves: the agent asks first
- Tested on
- Q8 Max+ SE (Q80ULL) · firmware 02.06.86
- 9 actions
- vacuum.start
- vacuum.pause
- vacuum.return_to_base
- vacuum.clean_spot
- vacuum.clean_area
- vacuum.locate
- vacuum.set_fan_speed
- vacuum.send_command
- roborock.set_vacuum_goto_position
Everything built for it
12 projects from the index, most active first.
- Hypfer/ValetudoCloud-free web UI and firmware replacement for robot vacuums (Roborock, Dreame)Active★ 9.8K
- PiotrMachowski/Xiaomi-cloud-tokens-extractorThis tool retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE devices.Active★ 4.9K
- PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-ExtractorLive maps for Xiaomi, Roborock, Viomi and Dreame vacuums pulled from the undocumented Xiaomi cloudActive★ 1.4K
- Python-roborock/local_roborock_serverEmulates Roborock's cloud (HTTPS/MQTT) so vacuums work without internetActive★ 1.1K
- homebridge-xiaomi-roborock-vacuum/homebridge-xiaomi-roborock-vacuumHomebridge plugin for Xiaomi Roborock vacuums over the miIO protocolActive★ 395
- Python-roborock/python-roborockPython library for Roborock vacuums via the reverse-engineered cloud and local APIsActive★ 242
- zvldz/vacuumCustom firmware builder for Roborock gen1/gen2 vacuumsActive★ 158
- tasict/homebridge-roborock-vacuumHomebridge plugin that integrates Roborock vacuums with Apple HomeKitActive★ 40
- konqi/roborock-bridgeBridge between a local MQTT broker and Roborock vacuums through the vendor's private APIsActive★ 11
- rand256/valetudoCloud-free software fork for Roborock and Xiaomi vacuumsSlow★ 714
- humbertogontijo/homeassistant-roborockRoborock integration for Home Assistant using the Roborock app's APIArchived★ 742
- LazyT/rrccRoboRock Control Center desktop clientArchived★ 589