{"id":13579966,"url":"https://github.com/davidusb-geek/emhass","last_synced_at":"2026-04-01T18:39:07.416Z","repository":{"id":37501970,"uuid":"405738860","full_name":"davidusb-geek/emhass","owner":"davidusb-geek","description":"emhass: Energy Management for Home Assistant, is a Python module designed to optimize your home energy interfacing with Home Assistant.","archived":false,"fork":false,"pushed_at":"2025-04-02T11:50:55.000Z","size":27894,"stargazers_count":374,"open_issues_count":41,"forks_count":83,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-05T03:05:24.421Z","etag":null,"topics":["energy","home-automation","linear-programming","management","model-predictive-control","optimization"],"latest_commit_sha":null,"homepage":"https://emhass.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidusb-geek.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2021-09-12T19:49:39.000Z","updated_at":"2025-04-03T11:22:45.000Z","dependencies_parsed_at":"2023-12-21T23:38:37.541Z","dependency_job_id":"763769b4-164b-439e-a1e6-54ec8439430e","html_url":"https://github.com/davidusb-geek/emhass","commit_stats":{"total_commits":1268,"total_committers":19,"mean_commits":66.73684210526316,"dds":0.5488958990536277,"last_synced_commit":"fac2df9e829c0ebec034a7c702d9beb1b65bee23"},"previous_names":[],"tags_count":116,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidusb-geek%2Femhass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidusb-geek%2Femhass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidusb-geek%2Femhass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidusb-geek%2Femhass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidusb-geek","download_url":"https://codeload.github.com/davidusb-geek/emhass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247415794,"owners_count":20935383,"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":["energy","home-automation","linear-programming","management","model-predictive-control","optimization"],"created_at":"2024-08-01T15:01:45.372Z","updated_at":"2026-04-01T18:39:07.409Z","avatar_url":"https://github.com/davidusb-geek.png","language":"Python","funding_links":[],"categories":["Python","Energy Systems"],"sub_categories":["Building Energy Monitoring"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg alt=\"EMHASS\" src=\"https://raw.githubusercontent.com/davidusb-geek/emhass/master/docs/images/logo_docs.png\" width=\"700px\"\u003e\n  \u003ch1\u003eEnergy Management for Home Assistant\u003c/h1\u003e\n  \u003cstrong\u003e\u003c/strong\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://pypi.org/project/emhass/\"\u003e\n    \u003cimg alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/emhass\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://anaconda.org/channels/davidusb/packages/emhass/overview\"\u003e\n    \u003cimg alt=\"Conda - Version\" src=\"https://img.shields.io/conda/v/davidusb/emhass\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://github.com/davidusb-geek/emhass/actions\"\u003e\n    \u003cimg alt=\"EMHASS GitHub Workflow Status\" src=\"https://github.com/davidusb-geek/emhass/actions/workflows/publish_docker.yaml/badge.svg?event=release\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://github.com/davidusb-geek/emhass/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/davidusb-geek/emhass\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://pypi.org/project/emhass/\"\u003e\n    \u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/emhass\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://pypi.org/project/emhass/\"\u003e\n    \u003cimg alt=\"PyPI - Status\" src=\"https://img.shields.io/pypi/status/emhass\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://emhass.readthedocs.io/en/latest/\"\u003e\n    \u003cimg alt=\"Read the Docs\" src=\"https://img.shields.io/readthedocs/emhass\"\u003e\n  \u003c/a\u003e\n    \u003ca hstyle=\"text-decoration:none\" ref=\"https://codecov.io/github/davidusb-geek/emhass\" \u003e\n    \u003cimg src=\"https://codecov.io/github/davidusb-geek/emhass/branch/master/graph/badge.svg?token=BW7KSCHN90\"/\u003e\n  \u003c/a\u003e\n  \u003ca hstyle=\"text-decoration:none\" ref=\"https://github.com/davidusb-geek/emhass/actions/workflows/codeql.yml\" \u003e\n    \u003cimg src=\"https://github.com/davidusb-geek/emhass/actions/workflows/codeql.yml/badge.svg?branch=master\u0026event=schedule\"/\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://sonarcloud.io/summary/new_code?id=davidusb-geek_emhass\"\u003e\n    \u003cimg alt=\"SonarQube security rating\" src=\"https://sonarcloud.io/api/project_badges/measure?project=davidusb-geek_emhass\u0026metric=security_rating\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://sonarcloud.io/summary/new_code?id=davidusb-geek_emhass\"\u003e\n    \u003cimg alt=\"SonarQube security Vulnerabilities\" src=\"https://sonarcloud.io/api/project_badges/measure?project=davidusb-geek_emhass\u0026metric=vulnerabilities\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://sonarcloud.io/summary/new_code?id=davidusb-geek_emhass\"\u003e\n    \u003cimg alt=\"SonarQube reliability\" src=\"https://sonarcloud.io/api/project_badges/measure?project=davidusb-geek_emhass\u0026metric=reliability_rating\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://sonarcloud.io/summary/new_code?id=davidusb-geek_emhass\"\u003e\n    \u003cimg alt=\"SonarQube bugs\" src=\"https://sonarcloud.io/api/project_badges/measure?project=davidusb-geek_emhass\u0026metric=bugs\"\u003e\n  \u003c/a\u003e\n  \n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n \u003ca style=\"text-decoration:none\" href=\"https://emhass.readthedocs.io/en/latest/\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/davidusb-geek/emhass/master/docs/images/Documentation_button.svg\" alt=\"Documentation\"\u003e\n  \u003c/a\u003e\n   \u003ca style=\"text-decoration:none\" href=\"https://community.home-assistant.io/t/emhass-an-energy-management-for-home-assistant/338126\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/davidusb-geek/emhass/master/docs/images/Community_button.svg\" alt=\"Community\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://github.com/davidusb-geek/emhass/issues\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/davidusb-geek/emhass/master/docs/images/Issues_button.svg\" alt=\"Issues\"\u003e\n  \u003c/a\u003e\n  \u003ca style=\"text-decoration:none\" href=\"https://github.com/davidusb-geek/emhass-add-on\"\u003e\n     \u003cimg src=\"https://raw.githubusercontent.com/davidusb-geek/emhass/master/docs/images/EMHASS_Add_on_button.svg\" alt=\"EMHASS Add-on\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\u003cp align=\"left\"\u003e\nEMHASS is a Python module designed to optimize your home energy interfacing with Home Assistant.\n\u003c/p\u003e\n\n## Introduction\n\nEMHASS (Energy Management for Home Assistant) is an optimization tool designed for residential households. The package uses a Linear Programming approach to optimize energy usage while considering factors such as electricity prices, power generation from solar panels, and energy storage from batteries. EMHASS provides a high degree of configurability, making it easy to integrate with Home Assistant and other smart home systems. Whether you have solar panels, energy storage, or just a controllable load, EMHASS can provide an optimized daily schedule for your devices, allowing you to save money and minimize your environmental impact.\n\nThe complete documentation for this package is [available here](https://emhass.readthedocs.io/en/latest/).\n\nTo get started you can follow our [🚀 Quick Start](/docs/quick_start.md) guide in the documentation.\n\nHere are the guides for:\n- [📦 Installation methods](/docs/installation_methods.md)\n- [📖 Usage](/docs/usage_guide.md)\n- [🤖 Home Assistant Automations](/docs/automations.md)\n\n## Development\n\nPull requests are very much accepted on this project. For development, you can find some instructions here [Development](/docs/develop.md).\n\n## License\n\nMIT License\n\nCopyright (c) 2021-2026 David HERNANDEZ TORRES\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidusb-geek%2Femhass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidusb-geek%2Femhass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidusb-geek%2Femhass/lists"}