explaingit

hypfer/valetudo

9,067JavaScriptAudience · generalComplexity · 4/5LicenseSetup · hard

TLDR

Valetudo replaces the cloud connection on robot vacuums (Roborock, Dreame, Xiaomi) so your robot works entirely on your home network with no manufacturer account or internet required.

Mindmap

mindmap
  root((valetudo))
    What it does
      Cloud replacement
      Local control
      No data sharing
    Supported robots
      Roborock
      Dreame
      Xiaomi
    Interface
      Web browser UI
      MQTT integration
      REST API
    Smart home
      Home Assistant
      Automation
    Setup
      Supported hardware
      Technical install
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Control your Roborock or Dreame robot vacuum from a local web page with no internet connection or manufacturer account.

USE CASE 2

Integrate your robot vacuum into Home Assistant or other smart home platforms using MQTT messages.

USE CASE 3

Automate cleaning schedules by calling the REST API from any other program on your home network.

USE CASE 4

Stop your robot from sending usage data or receiving ads from the manufacturer's cloud service.

Tech stack

JavaScriptMQTTREST API

Getting it running

Difficulty · hard Time to first run · 1day+

Requires a supported robot model and hardware-specific installation steps documented on the project's external documentation site.

Use, modify, and distribute freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Valetudo is software that replaces the cloud connection on certain robot vacuum cleaners so they can run entirely on your local network without sending data to the manufacturer's servers. It works with robots from brands including Roborock, Dreame, and Xiaomi. Importantly, it is not a custom firmware: it runs alongside the robot's original software rather than replacing it, which means you still benefit from the engineering the manufacturer put into the robot's core behavior. The problem Valetudo solves is that many modern robot vacuums require an account and an internet connection to function. The manufacturer's app may show ads, push subscription upgrades, or stop working if the company changes its cloud service. Valetudo sidesteps all of that by intercepting the robot's communication and providing a self-hosted web interface you access directly on your home network. Once installed, you control the robot through a web page that works on phones, tablets, and desktop browsers. For smart home setups, Valetudo integrates with Home Assistant and similar platforms using MQTT, a standard messaging protocol. It also exposes a REST API with built-in documentation, so technical users can automate cleaning from other systems. The project is maintained by a single developer as a personal hobby project and is explicit about this. The README uses the metaphor of a privately-owned public garden: free to use and enjoy, but not community-governed. Feature direction is the author's call, and the project is not designed to grow its audience or commercialize. This is relevant context if you are evaluating it for a setup that depends on active, community-driven maintenance. Valetudo is open source under the Apache 2.0 license. Installation requires a supported robot and some technical comfort, as you will need to consult the project's documentation site for steps specific to your hardware model.

Copy-paste prompts

Prompt 1
I have a Roborock S5 and want to set up Valetudo so it works without the cloud app. What do I need to do first?
Prompt 2
How do I connect my Valetudo robot vacuum to Home Assistant using MQTT so I can trigger cleaning from automations?
Prompt 3
Show me how to call the Valetudo REST API to send my robot to a specific room at a scheduled time.
Prompt 4
What are the trade-offs of using Valetudo instead of the official Roborock app for someone who is not very technical?
Open on GitHub → Explain another repo

← hypfer on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.