Skip to main content

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:

  1. Add the Energy Assistant repository to your Home Assistant instance.
  2. Install the Energy Assistant add-on.

Add repository on my Home Assistant

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:

  1. Go to Energy Assistant backend repository and click "fork".
  2. Clone the forked repository locally (git clone ...)
  3. Open the devcontainer in VSCode
  4. Copy energy_assistan.yaml.dist to energy_assistan.yaml and configure your setup (e.g. connection to Home Assistant)
  5. Press F5 to start Energy Assistant
  6. Go to Energy Assistant frontend repository and click "fork".
  7. Clone the forked repository locally (git clone ...)
  8. Open the devcontainer in VSCode
  9. Enter yarn install and then yarn dev in 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)

Source distribution for energy_assistant 0.1.30
File Size Uploaded
energy_assistant-0.1.30.tar.gz 64.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for energy_assistant 0.1.30
File Interpreter ABI Platform
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
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page