{"id":13468157,"url":"https://github.com/Hypfer/Valetudo","last_synced_at":"2025-03-26T05:30:57.160Z","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-03-20T17:50:51.000Z","size":227893,"stargazers_count":7164,"open_issues_count":0,"forks_count":410,"subscribers_count":93,"default_branch":"master","last_synced_at":"2025-03-25T23:01:37.772Z","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},"funding":{"github":"hypfer","ko_fi":"hypfer"}},"created_at":"2018-07-12T07:07:43.000Z","updated_at":"2025-03-25T22:44:03.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":68,"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":245597201,"owners_count":20641859,"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-07-31T15:01:06.361Z","updated_at":"2025-03-26T05:30:57.143Z","avatar_url":"https://github.com/Hypfer.png","language":"JavaScript","funding_links":["https://github.com/sponsors/hypfer","https://ko-fi.com/hypfer"],"categories":["JavaScript","Interfaces","Projects","others","🔧 Utilities \u0026 Miscellaneous"],"sub_categories":["Misc"],"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\nBecause Valetudo is not a custom firmware, it cannot change anything about how the robot operates.\u003cbr/\u003e\nWhat it can do however is protect your data and enable you to connect your robot\nto your home automation system without having to detour through a vendor cloud, which,\napart from the whole data problematic, might not be reachable due to your internet connection\nbeing down or some servers in the datacenter being on fire.\n\nNot having to leave your local network of course also benefits the latency of commands, status reports etc.\n\nValetudo aims to be proof that easy to use and reliable smart appliances are possible without any cloud and/or account requirements.\nMaybe at some point it might help convince vendors that there is another way of doing things.\n\nBy default, Valetudo provides control over your vacuum robot via a **responsive webinterface** that works on all of your devices.\nIt can be used on phones, tablets as well as your desktop computer.\n\n\nFurthermore, there's a **REST-interface** documented with **Swagger UI** as well as **MQTT**.\nWith support for both **Homie** and **Home Assistant Autodiscovery** for MQTT, you should be able to connect Valetudo to\nthe open-source smarthome software of your choice.\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 src=\"https://user-images.githubusercontent.com/974410/211155741-d6430660-a6b2-48ab-8ddc-2217328444de.png\" width=360\u003e \u003cimg src=\"https://github.com/user-attachments/assets/eaad6fe0-dd1e-4f56-b6f9-f65954aecac7\" width=360\u003e\n\n\u003cimg src=\"https://user-images.githubusercontent.com/974410/211155650-7cac266c-ffeb-432d-8656-5241a5d6f227.png\" width=360\u003e \u003cimg src=\"https://user-images.githubusercontent.com/974410/211155656-d43ee25e-1ae6-432f-95ff-1a39d294828d.png\" width=360\u003e\n\n### Tablet/Desktop\n\n![image](https://github.com/user-attachments/assets/dc18723f-b15f-4500-907b-bad6d7dd1a4f)\n\n![image](https://user-images.githubusercontent.com/974410/211155836-9199616a-efde-4238-91c4-24158ba67677.png)\n\n![image](https://user-images.githubusercontent.com/974410/211155860-9926b126-d1fe-41b1-8c83-1af21bf8caf2.png)\n\n![image](https://user-images.githubusercontent.com/974410/211155880-ff184776-86fe-4c2f-9556-4d556cfa12f4.png)\n\n\n\n## Further questions?\n[Valetudo Telegram group](https://t.me/+k-ukcsX2ZYg5MDky)\n\n## Contributing\n\nMake sure to familiarize yourself with the [./CONTRIBUTING.md](./CONTRIBUTING.md)\n\n\n## Honourable mentions\n\nValetudo and its companion applications are developed using JetBrains IDEs such as [WebStorm](https://www.jetbrains.com/webstorm/).\nLicenses for those have been provided for free by JetBrains to the project in context of [their open source support program](https://jb.gg/OpenSourceSupport) since multiple years now.\n\nThanks a lot for that!\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"}