<!--
  DOCS.md is used by Home Assistant for the Add-on Store documentation.
-->

# Akkudoktor-EOS – Home Assistant Add-on Documentation

## Overview

**Akkudoktor-EOS** is a Home Assistant add-on that optimizes household energy flows such as battery storage, photovoltaic (PV) generation, grid usage, and controllable loads.

The add-on is designed to be *practical and user-focused*: once configured, it runs automatically in the background and integrates seamlessly with Home Assistant. Advanced optimization logic and simulations are handled internally — no programming required.

EOS is especially suited for users who:

* Have a home battery and/or PV system
* Want to use forecasts to make smarter energy decisions
* Prefer a transparent, configurable, and locally running solution


## Features

* 🔋 Battery and storage optimization
* ☀️ PV forecast integration
* ⚡ Load and power profile optimization
* 🧠 Forecast-based optimization
* 🧩 Modular simulation and controller architecture
* 🏠 Native Home Assistant add-on integration
* 📊 Designed for extensibility with custom energy devices
