Skip to content
← All builds
Hypfer avatar

Open source

Hypfer/Valetudo

Cloud replacement for vacuum robots enabling local-only operation

9.9k starsJavaScriptUpdated 2d agoApache-2.0 license
cloud-freedreameroborockrobot-vacuumsmarthome
Install
$ git clone https://github.com/Hypfer/Valetudo.git# then ask your coding agent> Set up Valetudo for "Free your robot vacuum from the cloud with Valetudo"  on my Roborock. Follow the README.
No published photo or video yet: repository detailsHypfer/Valetudo
Free your robot vacuum from the cloud with Valetudo: Hypfer/Valetudo repository (image 2)
Free your robot vacuum from the cloud with Valetudo: Hypfer/Valetudo repository (image 3)

Free your robot vacuum from the cloud with Valetudo

Vacuum, Medium

Valetudo replaces the vendor cloud on supported Roborock and Dreame vacuums, giving you a local web UI, maps, and MQTT/Home Assistant control with no account.

View build on GitHub ↗Share on X

Valetudo is not custom firmware; it runs alongside vendor firmware as a local 'brain parasite', so you keep the vendor's navigation but lose the cloud, ads and subscriptions. You get room cleaning, no-go zones, and MQTT autodiscovery for Home Assistant.

Hardware & cost: A supported vacuum (check the Valetudo supported-robots list; many need rooting via the DustBuilder process). Software is free.

Difficulty: Medium. Rooting can void warranty; follow the docs for your exact model.

Agent install prompt (paste into Claude Code, Cursor or Codex): "Read https://valetudo.cloud docs and https://github.com/Hypfer/Valetudo, tell me if my vacuum model is supported and the rooting steps, then help me set up MQTT into Home Assistant once it's installed."

Source: Hypfer/Valetudo on GitHub — https://github.com/Hypfer/Valetudo (facts checked against the project README, Oct 2026; prices vary by region).

Quick answers

What do you need to free your robot vacuum from the cloud with Valetudo?
A supported vacuum (check the Valetudo supported-robots list; many need rooting via the DustBuilder process). Software is free.
How hard is it to free your robot vacuum from the cloud with Valetudo?
Medium. Rooting can void warranty; follow the docs for your exact model.
Interfaces

Ideas to try with it

Our ideas, not the builder's claims.

  1. Start a living room clean from Home Assistant when everyone leaves
  2. Pause the vacuum automatically when a video call starts
  3. Send the robot to a spot under the table from the local map
1 more idea
  1. Log every run's cleaned area to a dashboard
Source
Hypfer/Valetudo on GitHub
Last commit
2026-10-16
Builder
Hypfer
Repo
Hypfer/Valetudo, 9,904 stars
Built with
Roborock, Dreame

More like this: Robot vacuums

Parts notes for this device are in the Hermes Workshop catalog.

What to build next

Builds that share a board, robot or agent with this one.