Energy Assistant
Energy Assistant is a free, opensource Energy Management System which works together with Home Assistant and Evcc.
Energy Assistant is using Emhass in order to optimize the energy consumption of your house.
Documentation and support
For issues, please go to the issue tracker.
For feature requests, please see feature requests.
Running the Energy Assistant
Preferred method: Home Assistant Add-on
By far the most convenient way to run the Energy Assistant is to install the Energy Assistant Add-on:
- Add the Energy Assistant repository to your Home Assistant instance.
- Install the Energy Assistant add-on.
Alternative method: Docker image
An alternative way to run the Energy Assistant is by running the docker image:
Copy the energy_assistant.yaml.dist file to energy_assistant.yaml and modify it to match your setup and then start the docker container in the same folder.
docker run --name em -p 8080:5000 -v "$(pwd)/energy_assistant.yaml:/config/energy_assistant.yaml" ghcr.io/pail23/energy-assistant-server:latest
Configure Energy Assistant
Please find information on how to configure Energy Assistant here.
User documentation
Please consult the user documentation for Energy Assistant.
Local Development
The easiest way to get started with development is to use Visual Studio Code with devcontainers. This approach will create a preconfigured development environment with all the tools you need. This approach is enabled for the Energy Assistant frontend and the Energy Assistant backend repository. Learn more about devcontainers.
Getting started:
- Go to Energy Assistant backend repository and click "fork".
- Clone the forked repository locally (git clone ...)
- Open the devcontainer in VSCode
- Copy
energy_assistan.yaml.disttoenergy_assistan.yamland configure your setup (e.g. connection to Home Assistant) - Press F5 to start Energy Assistant
- Go to Energy Assistant frontend repository and click "fork".
- Clone the forked repository locally (git clone ...)
- Open the devcontainer in VSCode
- Enter
yarn installand thenyarn devin the Terminal of VSCode
Useful commands:
./scripts/lint.sh run the linter to check the code quality.
./scripts/create-dev-db.sh create a new database in the root folder of the project.
Metadata
Release files for energy_assistant 0.1.30
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| energy_assistant-0.1.30.tar.gz | 64.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| energy_assistant-0.1.30-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 165.3 kB
Release files / energy_assistant-0.1.30.tar.gz
| Download URL | energy_assistant-0.1.30.tar.gz |
|---|---|
| Size | 64.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8369a8a36938f0e6bf8fc314d19d8b0876600688f32c45855f367aa604df172c
|
|
BLAKE2b-256 checksum How to use checksums |
2abcc4ba0a340e859fe7d58e4ab0cf496336265962370dc22c10dde36a027121
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.13
|
Release files / energy_assistant-0.1.30-py3-none-any.whl
| Download URL | energy_assistant-0.1.30-py3-none-any.whl |
|---|---|
| Size | 101.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9ecce4af852f1f2dad7074f057f52f83aa4b14bbe13df4346cf166671b857678
|
|
BLAKE2b-256 checksum How to use checksums |
871e6620799a3f3da116a0731ecb9a6bd15ef292441d744db5e3d8d57b57bc76
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.13
|