Home

Awesome

<div align="center"> <img src="https://github.com/Hypfer/Valetudo/blob/master/assets/logo/valetudo_logo_with_name.svg" width="800" alt="valetudo"> <p align="center"><h2>Free your vacuum from the cloud</h2></p> </div>

Valetudo is a cloud replacement for vacuum robots enabling local-only operation. It is not a custom firmware.<br/> Here's a diagram illustrating the core operation principle:

<img src="https://github.com/Hypfer/valetudo/raw/master/docs/_pages/general/img/operation_principle.png" height=450>

Because Valetudo is not a custom firmware, it cannot change anything about how the robot operates.<br/> What it can do however is protect your data and enable you to connect your robot to your home automation system without having to detour through a vendor cloud, which, apart from the whole data problematic, might not be reachable due to your internet connection being down or some servers in the datacenter being on fire.

Not having to leave your local network of course also benefits the latency of commands, status reports etc.

Valetudo aims to be proof that easy to use and reliable smart appliances are possible without any cloud and/or account requirements. Maybe at some point it might help convince vendors that there is another way of doing things.

By default, Valetudo provides control over your vacuum robot via a responsive webinterface that works on all of your devices. It can be used on phones, tablets as well as your desktop computer.

Furthermore, there's a REST-interface documented with Swagger UI as well as MQTT. With support for both Homie and Home Assistant Autodiscovery for MQTT, you should be able to connect Valetudo to the open-source smarthome software of your choice.

For more information, check out the newcomer guide, the getting started guide and also the docs in general at https://valetudo.cloud

There, you will find a list of supported robots.

Screenshots

Phone/Mobile

<img src="https://user-images.githubusercontent.com/974410/211155741-d6430660-a6b2-48ab-8ddc-2217328444de.png" width=360> <img src="https://github.com/user-attachments/assets/eaad6fe0-dd1e-4f56-b6f9-f65954aecac7" width=360>

<img src="https://user-images.githubusercontent.com/974410/211155650-7cac266c-ffeb-432d-8656-5241a5d6f227.png" width=360> <img src="https://user-images.githubusercontent.com/974410/211155656-d43ee25e-1ae6-432f-95ff-1a39d294828d.png" width=360>

Tablet/Desktop

image

image

image

image

Further questions?

Valetudo Telegram group

Contributing

Make sure to familiarize yourself with the ./CONTRIBUTING.md

Honourable mentions

Valetudo and its companion applications are developed using JetBrains IDEs such as WebStorm. Licenses for those have been provided for free by JetBrains to the project in context of their open source support program since multiple years now.

Thanks a lot for that!