EHMASS

Energy Management for Home Assistant, is a Python module designed to optimize your home energy interfacing with Home Assistant.
https://github.com/davidusb-geek/emhass

Category: Energy Systems
Sub Category: Building Energy Monitoring

Keywords

energy home-automation linear-programming management model-predictive-control optimization

Keywords from Contributors

hacs varta varta-storage power

Last synced: about 20 hours ago
JSON representation

Repository metadata

emhass: Energy Management for Home Assistant, is a Python module designed to optimize your home energy interfacing with Home Assistant.

Host: GitHub
URL: https://github.com/davidusb-geek/emhass
Owner: davidusb-geek
License: mit
Created: 2021-09-12T19:49:39.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2026-01-11T21:13:32.000Z (6 days ago)
Last Synced: 2026-01-11T21:53:07.895Z (6 days ago)
Topics: energy, home-automation, linear-programming, management, model-predictive-control, optimization
Language: Python
Homepage: https://emhass.readthedocs.io
Size: 33.5 MB
Stars: 489
Watchers: 22
Forks: 114
Open Issues: 37
Releases: 103
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Introduction

EMHASS (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.

The complete documentation for this package is available here.

To get started you can follow our 🚀 Quick Start guide in the documentation.

Here are the guides for:

Development

Pull requests are very much accepted on this project. For development, you can find some instructions here Development.

License

MIT License

Permission 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:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE 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.

Owner metadata

Name: David
Login: davidusb-geek
Email:
Kind: user
Description:
Website:
Location: Grenoble, France
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/32926550?u=34745060603752649ba6cf501f18e8f707537b2d&v=4
Repositories: 2
Last ynced at: 2023-03-05T05:24:16.519Z
Profile URL: https://github.com/davidusb-geek

GitHub Events

Total

Create event: 43
Commit comment event: 4
Release event: 16
Issues event: 153
Watch event: 125
Delete event: 16
Issue comment event: 864
Push event: 179
Pull request review comment event: 67
Pull request review event: 103
Pull request event: 184
Fork event: 37

Last Year

Create event: 39
Commit comment event: 4
Issues event: 144
Release event: 14
Watch event: 120
Delete event: 12
Issue comment event: 776
Push event: 167
Pull request review comment event: 67
Pull request event: 166
Pull request review event: 94
Fork event: 36

Committers metadata

Last synced: 3 months ago

Total Commits: 1,647
Total Committers: 31
Avg Commits per committer: 53.129
Development Distribution Score (DDS): 0.593

Commits in past year: 472
Committers in past year: 22
Avg Commits per committer in past year: 21.455
Development Distribution Score (DDS) in past year: 0.525

Name	Email	Commits
davidusb-geek	d**b@g**m	671
GeoDerp	1****p	516
Giel Janssens	g**s@m**m	112
David HERNANDEZ	d**z@N**v	72
Michaël Piron	4****n	53
Paul Homes	p**s@t**m	29
dependabot[bot]	4****]	28
g1za	8****a	23
Mark Purcell	7****b	23
Steven Cruysberghs	s**n@s**e	15
DH271725	d**s@c**r	14
Chris Rosenhain	c**s@r**n	11
James McMahon	j**n@p**t	11
Paul Frank	p**l@g**t	10
Radim	1****j	10
Andrew Garrett	a**t@g**m	7
polyfloyd	f**d@p**t	7
nielskool	n**l@l**l	6
Squazel	6****l	5
Simon Berger	s**n@s**o	4
Alex Kruger	a**k@l**u	3
Ryan Mounce	r**n@m**u	3
github-actions[bot]	4****]	3
BDVGitHub	1****b	2
Chris Abberley	2****y	2
Jaap P.	a**m@g**m	2
Andrew Cottrell	U****n	1
Kay Cee	3****u	1
majorfrog	1****g	1
HERNANDEZ TORRES David	D**5@i**r	1
and 1 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 3 months ago

Total issues: 265
Total pull requests: 454
Average time to close issues: about 1 month
Average time to close pull requests: 10 days
Total issue authors: 112
Total pull request authors: 31
Average comments per issue: 4.11
Average comments per pull request: 3.27
Merged pull request: 361
Bot issues: 0
Bot pull requests: 60

Past year issues: 93
Past year pull requests: 181
Past year average time to close issues: 20 days
Past year average time to close pull requests: 6 days
Past year issue authors: 45
Past year pull request authors: 21
Past year average comments per issue: 2.88
Past year average comments per pull request: 3.06
Past year merged pull request: 145
Past year bot issues: 0
Past year bot pull requests: 2

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/davidusb-geek/emhass

Top Issue Authors

purcell-lab (28)
GeoDerp (11)
overas (9)
g1za (9)
BDVGitHub (9)
davidusb-geek (9)
gieljnssns (8)
martinarva (8)
scruysberghs (7)
paulhomes (6)
sti0 (5)
radim2tej (5)
Octofinger (5)
heinemannj (5)
smitterer (4)

Top Pull Request Authors

GeoDerp (165)
davidusb-geek (88)
dependabot[bot] (60)
paulhomes (18)
purcell-lab (18)
werdnum (11)
polyfloyd (11)
radim2tej (8)
scruysberghs (8)
g1za (7)
michaelpiron (7)
gieljnssns (7)
Crosenhain (7)
nielskool (5)
Gruek (4)

Top Issue Labels

enhancement (27)
wontfix (16)
help wanted (6)
question (5)
bug (2)
documentation (1)
invalid (1)
duplicate (1)
good first issue (1)

Top Pull Request Labels

dependencies (60)

Package metadata

Total packages: 2
Total downloads:
- pypi: 402 last-month
Total docker downloads: 1,748
Total dependent packages: 1 (may contain duplicates)
Total dependent repositories: 1 (may contain duplicates)
Total versions: 244
Total maintainers: 1

proxy.golang.org: github.com/davidusb-geek/emhass

Homepage:
Documentation: https://pkg.go.dev/github.com/davidusb-geek/emhass#section-documentation
Licenses: mit
Latest release: v0.13.5 (published 4 months ago)
Last Synced: 2025-10-29T20:19:07.749Z (3 months ago)
Versions: 120
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%

pypi.org: emhass

An Energy Management System for Home Assistant

Homepage: https://github.com/davidusb-geek/emhass
Documentation: https://emhass.readthedocs.io/en/latest/
Licenses: MIT
Latest release: 0.13.5 (published 4 months ago)
Last Synced: 2025-10-29T20:19:07.263Z (3 months ago)
Versions: 124
Dependent Packages: 1
Dependent Repositories: 1
Downloads: 402 Last month
Docker Downloads: 1,748
Rankings:
- Stargazers count: 5.197%
- Dependent packages count: 7.306%
- Forks count: 7.699%
- Average: 11.161%
- Downloads: 13.525%
- Dependent repos count: 22.077%
Maintainers (1)
- davidusb

Dependencies

docs/requirements.txt pypi

beautifulsoup4 >=4.9.3
docutils ==0.16
jinja2 <3.0
markupsafe ==2.0.1
myst-parser ==0.14.0
netcdf4 >=1.5.3
numpy >=1.20.1
pandas >=1.2.3
protobuf >=3.0.0
pulp >=2.4
pvlib >=0.9.0
pytz >=2021.1
pyyaml >=5.4.1
requests >=2.25.1
siphon >=0.9
sphinx ==3.5.4
sphinx-rtd-theme ==0.5.2
tables >=3.6.1

requirements.txt pypi

beautifulsoup4 >=4.9.3
netcdf4 >=1.5.3
numpy >=1.20.1
pandas >=1.2.3
protobuf >=3.0.0
pulp >=2.4
pvlib >=0.9.0
pytz >=2021.1
pyyaml >=5.4.1
requests >=2.25.1
siphon >=0.9
tables >=3.6.1

requirements_webserver.txt pypi

beautifulsoup4 >=4.9.3
flask >=2.0.3
netcdf4 >=1.5.3
numpy >=1.20.1
pandas >=1.2.3
plotly >=5.6.0
protobuf >=3.0.0
pulp >=2.4
pvlib >=0.9.0
pytz >=2021.1
pyyaml >=5.4.1
requests >=2.25.1
siphon >=0.9
tables >=3.6.1
waitress >=2.1.1

setup.py pypi

beautifulsoup4 >=4.9.3
netcdf4 >=1.5.3
numpy >=1.20.1
pandas >=1.2.3
protobuf >=3.0.0
pulp >=2.4
pvlib >=0.8.1
pytz >=2021.1
pyyaml >=5.4.1
requests >=2.25.1
siphon >=0.9
tables >=3.6.1

.github/workflows/codecov.yaml actions

actions/checkout master composite
actions/setup-python master composite

.github/workflows/codeql.yml actions

actions/checkout v3 composite
github/codeql-action/analyze v2 composite
github/codeql-action/init v2 composite

.github/workflows/publish_docker.yaml actions

actions/checkout v3 composite
docker/build-push-action v3 composite
docker/login-action v2 composite
docker/metadata-action v4 composite
docker/setup-buildx-action v2 composite
docker/setup-qemu-action v2 composite

.github/workflows/python-test.yml actions

actions/checkout v3 composite
actions/setup-python v4 composite

.github/workflows/upload-package-to-pypi.yaml actions

actions/checkout master composite
actions/setup-python master composite

Dockerfile docker

python 3.8-slim-buster build

.devcontainer/Dockerfile docker

mcr.microsoft.com/devcontainers/python 1-3.8-buster build

pyproject.toml pypi

Score: 17.37437027493919

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology