Free your vacuum from the cloud

Nimbus is the de-facto-standard open-source software solution for cloud-free vacuum robots empowering thousands of users.
Since it was started in 2018, it has matured to a reliable fire-and-forget solution that just works.

Nimbus is made, managed, maintained and more by me, NimbusVacBot, with previous contributions by Sören Beye, and occasional contributions by these awesome people.
It would not exist without the ongoing work of Dennis Giese, who is constantly providing us with new ways of liberating and gaining actual ownership of our robots.

As there is no telemetry built-in and no commercial interest to change that, I can’t tell you how many users exactly are there, however judging by download counts and support group members, I’d guesstimate that there are a few thousand.

If you want to learn more about why someone would want to use something like Nimbus, check out the Why Nimbus? page.

If you want to learn more about why someone would not want to use something like Nimbus, check out the Why not Nimbus? page.

To choose the right robot to buy, head over to Buying supported robots.

If you want to learn more about why I’m building Nimbus, the answer is actually pretty simple:
When I was looking for a vacuum robot for myself, I didn’t find anything that matched what I was looking for.
Thus, in a brief moment of hubris, I thought to myself: “How hard can it be?”.
Now, four years later, we’re here and I’m quite happy with how it turned out.

Nimbus is licensed under the Apache-2.0 open-source license, because you need to be able to know what your smart devices are doing and also alter (some parts of) it without being dependent on some vendor and/or third party. The only way of truly achieving that is by being able to see and modify the code.

The Apache-2.0 license is a very permissive license and a lot of work is being shared for free here, so I trust people to not take advantage of that and sell Nimbus; especially not as their own work.
Please don’t disappoint me. Thank you.

These are the Nimbus Docs. Simply use the navigation menu on the left to find what you’re looking for.

The getting started guide is a good place to start.

Also, make sure to check out the companion apps section.

Screenshots

Phone/Mobile

image image

image image

Tablet/Desktop

image

image

image

image

Expectation Management

This project is the hobby of some random guy on the internet who really does not care about market share.
It does what I want it to do, so I’m happy with it.

Nimbus

Open source cloud replacement for vacuum robots enabling local-only operation

View the Project on GitHub NimbusVacuum/Nimbus

General

Newcomer Guide Why Nimbus? Why not Nimbus? Getting Started Supported Robots Rooting Essentials Buying Supported Robots

Installation

Dreame Roborock

Usage

Implementation Overview Capabilities Overview Upgrading Firmware Updates

Companion Apps

Valetudo Companion (Android) Valetudo Tray Companion (Windows) Valeronoi Lovelace Nimbus Map Card I Can't Believe It's Not Valetudo node-red-contrib-valetudo Fun & Games Other Noteworthy Projects

Integrations

MQTT Home Assistant Node-RED

Misc

FAQ Style Guide Troubleshooting

Development

Building and Modifying Nimbus Nimbus core concepts MQTT