{"id":15121493,"url":"https://github.com/hypfer/valetudo","last_synced_at":"2026-01-25T16:11:11.648Z","repository":{"id":38549718,"uuid":"140675080","full_name":"Hypfer/Valetudo","owner":"Hypfer","description":"Cloud replacement for vacuum robots enabling local-only operation","archived":false,"fork":false,"pushed_at":"2025-05-06T16:47:57.000Z","size":227941,"stargazers_count":7276,"open_issues_count":0,"forks_count":413,"subscribers_count":97,"default_branch":"master","last_synced_at":"2025-05-06T17:48:01.382Z","etag":null,"topics":["cloud-free","dreame","roborock","robot-vacuum","smarthome","valetudo","xiaomi"],"latest_commit_sha":null,"homepage":"https://valetudo.cloud","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hypfer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"hypfer","ko_fi":"hypfer"}},"created_at":"2018-07-12T07:07:43.000Z","updated_at":"2025-05-06T16:48:01.000Z","dependencies_parsed_at":"2023-02-16T00:15:37.997Z","dependency_job_id":"455de295-e827-4d3b-bdf1-7e57e0ed446f","html_url":"https://github.com/Hypfer/Valetudo","commit_stats":null,"previous_names":[],"tags_count":69,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2FValetudo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2FValetudo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2FValetudo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2FValetudo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hypfer","download_url":"https://codeload.github.com/Hypfer/Valetudo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253747494,"owners_count":21957766,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-free","dreame","roborock","robot-vacuum","smarthome","valetudo","xiaomi"],"created_at":"2024-09-26T02:00:57.153Z","updated_at":"2026-01-25T16:11:11.641Z","avatar_url":"https://github.com/Hypfer.png","language":"JavaScript","funding_links":["https://github.com/sponsors/hypfer","https://ko-fi.com/hypfer"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/Hypfer/Valetudo/blob/master/assets/logo/valetudo_logo_with_name.svg\" width=\"800\" alt=\"valetudo\"\u003e\n    \u003cp align=\"center\"\u003e\u003ch2\u003eFree your vacuum from the cloud\u003c/h2\u003e\u003c/p\u003e\n\u003c/div\u003e\n\nValetudo is a cloud replacement for vacuum robots enabling local-only operation. It is not a custom firmware.\u003cbr/\u003e\nHere's a diagram illustrating the core operation principle:\n\n[\u003cimg src=\"https://github.com/Hypfer/valetudo/raw/master/docs/_pages/general/img/operation_principle.png\" height=450\u003e](https://github.com/Hypfer/valetudo/raw/master/docs/_pages/general/img/operation_principle.png)\n\nYou can think of it as a (quoting a user) \"brain parasite\" for the vendor firmware.\n\nThis comes with pro's and con's, with the main pro being that we get to benefit from the hundreds of thousands of hours of\nR\u0026D the vendors put into their firmwares, but without the cloud and account requirements.\n\nAs such, it protects your data through not sharing it with anyone by being fully local, saves you from in-app ads, upselling, sudden subscriptions\nand all the other fun enshittification tactics and playbooks.\n\nValetudo aims to be a generic abstraction, providing a responsive webinterface that allows control of the robot.\nIt can be used on phones, tablets as well as your desktop computer.\n\nTo integrate with other systems, it provides a REST-interface with inbuilt Swagger UI as documentation.\nAdditionally, it integrates with Home Assistant and other smarthome systems using MQTT.\n\nBeing a generic abstraction, Valetudo won't be a \"feature-complete\" reimplementation of the vendor apps, as that would also\nmean inheriting all of their technical debt.\nIt does however support everything you need to have a proper, modern, cloud-free robot vacuum.\n\nWhile being published under the Apache-2.0 license and clearly being FOSS, the governance and development model Valetudo operates under\nis to be understood as that of \"Freeware with source available\". It is evidently much more than that when it comes to the freedoms provided by true FOSS,\nbut it is not the FOSS that only knows \"community-driven\" you might be used to from corporate co-option and come to expect when you read \"FOSS\".\n\nFor more information, check out the [newcomer guide](https://valetudo.cloud/pages/general/newcomer-guide.html),\nthe [getting started guide](https://valetudo.cloud/pages/general/getting-started.html) \nand also the docs in general at [https://valetudo.cloud](https://valetudo.cloud)\n\nThere, you will find a list of [supported robots](https://valetudo.cloud/pages/general/supported-robots.html).\n\n## Screenshots\n\n### Phone/Mobile\n\u003cimg width=\"360\" src=\"https://github.com/user-attachments/assets/21b6cb92-43e8-4c49-b7f4-e15bedaab094\" /\u003e \u003cimg width=\"360\" src=\"https://github.com/user-attachments/assets/e4b32931-1116-4d19-bece-e48746a89664\" /\u003e\n\n\u003cimg width=\"360\" src=\"https://github.com/user-attachments/assets/4fdad83d-3df1-4d24-929b-004ce6b3bff0\" /\u003e \u003cimg width=\"360\" src=\"https://github.com/user-attachments/assets/422d54c8-6546-4616-9cd6-c1239be78c32\" /\u003e\n\n### Tablet/Desktop\n\n\u003cimg width=\"1024\" src=\"https://github.com/user-attachments/assets/28e7dea0-db0a-482b-92ba-8e9774b2416f\" /\u003e\n\n\u003cimg width=\"1024\" src=\"https://github.com/user-attachments/assets/f9217069-ee10-42f4-8897-0c90703201b7\" /\u003e\n\n\u003cimg width=\"1024\" src=\"https://github.com/user-attachments/assets/d7281e75-32c7-4a1e-a10b-95aef3b06a78\" /\u003e\n\n\n## Valetudo is a garden\nThis project is the hobby of some random guy on the internet. There is no intent to commercialize it, grow it\nor expand the target audience of it. In fact, there is intent to explicitly not do that.\n\nThink of Valetudo as a privately-owned public garden. You can visit it any time for free and enjoy it.\nYou can spend time there, and you can bring an infinite amount of friends with you to enjoy it.\nYou can walk the pathways built there. You can sit on some patch of grass and maybe watch a Duck or something.\nYou can leave a tip in the tip jar at the entrance if you really enjoy it and want to support it flourish.\n\nYou can take inspiration from it and bring that home to your own garden, giving it a personal twist and adapting it as needed.\nYou can even make friendly suggestions if you have a really good idea that ties into the vision that is already there.\n\nBut, at the end of the day, you must understand that it is still privately-owned. You're on someone else's property\nover which you have no power at all. You will have to show the necessary respect. And - most importantly - you need to\nunderstand that letting you into this garden is a gift and should be treated as such.\n\nIf you don't like this garden because you don't like how it's structured, or you feel like it's missing something, or maybe\nI choose the wrong flowers to plant over there that's fine. It's just not for you then. You can leave at any time.\n\nThere is simply no ground to stand on to demand change to the garden. It doesn't matter if it would attract more people\nor if all the other gardens in town are doing something in a specific way. It doesn't matter if your idea of what gardens\neven are differs.\u003cbr/\u003e\nThis at the end of the day is simply private property with free public access as a gift to everyone.\n\nWhen it comes to software development, _everyone_ has access to infinite plots of undeveloped land that they can claim at any time.\nTherefore, a garden being build with a specific vision does not take away the ability for anyone else to build their own garden with a different vision.\n\n## Further questions?\n\n\u003e [!IMPORTANT]  \n\u003e Before asking/joining/interacting, remember that you're entering a workshop that - fueled by naive optimism - was made partially accessible to the public under strict conditions.\n\u003e\n\u003e I hang out there in my free time, and, as any human, I'd like to spend my free time pleasantly and surrounded by people that understand and respect me.\n\u003e Contrary to e.g. your workplace, where tolerating is all that is expected of you, understanding cannot be made optional in such a space, as the economics that allow it to exist would otherwise not work out.\n\n1. [dust_announce - Very low frequency updates about Valetudo and Rooting](https://t.me/dust_announce)\n\n2. [Valetudo Telegram group](https://t.me/+2MsKV8kILxJhNDAy)\n\n3. [So you've been banned?](https://valetudo.cloud/pages/general/so-youve-been-banned.html)\n\nAny other mediums such as IRC, Matrix or Reddit are unofficial channels not connected to the project and might contain incorrect or outdated information.\n\n\n## Contributing\n\nMake sure to familiarize yourself with the [./CONTRIBUTING.md](./CONTRIBUTING.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypfer%2Fvaletudo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypfer%2Fvaletudo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypfer%2Fvaletudo/lists"}