# Hypfer/Valetudo

Cloud replacement for vacuum robots enabling local-only operation

Repository: https://github.com/Hypfer/Valetudo
Canonical: https://ross.abutalabs.com/products/valetudo
Homepage: https://valetudo.cloud
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: xiaomi, roborock, cloud-free, robot-vacuum, smarthome, valetudo, dreame
Last push: 2026-08-25T18:25:57+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 84, longevity 100
- inputs: {"age_days": 2974, "days_push": 8, "days_rel": 30, "gap_med": 42, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9585, forks 507 (observed 2026-08-28T04:10:35.925661+00:00)

## What it is
Valetudo is a cloud replacement for vacuum robots that runs directly on the robot itself, enabling fully local-only operation without vendor cloud or account requirements. It provides a responsive web interface for robot control, plus REST and MQTT integrations for Home Assistant and other smarthome systems.

## Use cases
- control my robot vacuum without the vendor cloud
- integrate my Xiaomi vacuum with Home Assistant locally
- remove cloud and account requirements from my Dreame robot vacuum
- run my robot vacuum fully offline for privacy
- get a local web interface and MQTT for my Roborock vacuum
- avoid vendor app ads and subscriptions on my vacuum robot

## When to choose
- you own a supported Xiaomi, Roborock, Dreame, or Midea robot vacuum and want cloud-free local control
- you want MQTT/Home Assistant integration without vendor cloud dependencies
- privacy is a priority and you refuse to send map data to vendor servers
- you are comfortable rooting your robot and voiding its warranty

## When to avoid
- your robot model is not on the supported robots list
- you are unwilling to root the device or risk bricking it
- you want a feature-complete clone of the vendor app with all its extras
- you need iOS companion apps, Matter support, or HTTPS out of the box

## Facets
- artifact type: application
- maturity: active
- function: web-framework, http-server, middleware, configuration-management
- domain: iot, self-hosted, privacy
- platform: embedded, self-hosted
- tags: robot-vacuum, cloud-free, xiaomi, roborock, dreame, mqtt, home-assistant, rooting, firmware, smarthome, automation, linux, web-server

## Member repositories
- Hypfer/Valetudo (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:35.925661+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:21:54.837754+00:00, confidence not recorded.
  - readme: https://github.com/Hypfer/Valetudo (fetched 2026-08-28T04:10:35.925661+00:00, sha 83616da68b19)
  - homepage: https://valetudo.cloud (fetched 2026-08-29T08:21:54.550383+00:00, sha eed94f7af597)
  - site_page: https://valetudo.cloud/pages/general/getting-started (fetched 2026-08-29T08:21:54.559889+00:00, sha f590594aa7e1)
  - site_page: https://valetudo.cloud/pages/installation/dreame (fetched 2026-08-29T08:21:54.562064+00:00, sha d3dddc0672fb)
  - site_page: https://valetudo.cloud/pages/installation/midea (fetched 2026-08-29T08:21:54.565837+00:00, sha c7c2cdbb545d)
  - site_page: https://valetudo.cloud/pages/installation/roborock (fetched 2026-08-29T08:21:54.568288+00:00, sha 657dac7c504e)
  - site_page: https://valetudo.cloud/pages/integrations/mqtt (fetched 2026-08-29T08:21:54.571533+00:00, sha 708df405c4cd)
  - site_page: https://valetudo.cloud/pages/integrations/home-assistant-integration (fetched 2026-08-29T08:21:54.574910+00:00, sha 2f25f3a59d32)
  - site_page: https://valetudo.cloud/pages/faq (fetched 2026-08-29T08:21:54.577010+00:00, sha 6c76fdb22662)
- Data as of 2026-08-30T08:39:29.467469+00:00.