Akkudoktor-EOS / EOS
This repository features an Energy Optimization System (EOS) that optimizes energy distribution, usage for batteries, heat pumps& household devices. It includes predictive models for electricity prices (planned), load forecasting& dynamic optimization to maximize energy efficiency & minimize costs. Founder Dr. Andreas Schmitz (YouTube @akkudoktor)
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing Akkudoktor-EOS/EOS in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler view**Build optimized energy management plans for your home automation** AkkudoktorEOS is a comprehensive solution for simulating and optimizing energy systems based on renewable sources. Optimize your photovoltaic systems, battery storage, load management, and electric vehicles while considering real-time electricity pricing. Why use AkkudoktorEOS? AkkudoktorEOS can be used to build energy management plans that are optimized for your specific setup of PV system, battery, electric vehicle, household load and electricity pricing. It can be integrated into home automation systems such as NodeRED, Home Assistant, EVCC. 🏘️ Community We are an open-source community-driven project and we love to hear from you. Here are some ways to get involved: • GitHub Issue Tracker: discuss ideas and features, and report bugs. • Akkudoktor Forum: get direct suppport from the cummunity. What do people build with AkkudoktorEOS The community uses AkkudoktorEOS to minimize grid energy consumption and to maximize the revenue from grid energy feed in with their home automation system. • Andreas Schmitz, the Akkudoktor, uses EOS integrated in his NodeRED home automation system for OpenSource Energieoptimierung. • Jörg, meintechblog, uses EOS for day-ahead optimization for time-variable energy prices. See: So installiere ich EOS von Andreas Schmitz Why not use AkkudoktorEOS? AkkudoktorEOS does not control your home automation assets. It must be integrated into a home automation system. If you do not use a home automation system or you feel uncomfortable with the configuration effort needed for the integration you should better use other solutions. Quick Start Run EOS with Docker (access dashboard at ): System Requirements • **Python**: 3.11 or higher • **Architecture**: amd64, aarch64 (armv8) • **OS**: Linux, Windows, macOS > **Note**: Other architectures (armv6, armv7) require manual compilation of dependencies with Rust and GCC. Installation Home Assistant add-on ![Supports aarch64 Architecture][aarch64-shield] ![Supports amd64 Architecture][amd64-shield] [aarch64-shield]: https://img.shields.io/badge/aarch64-yes-green.svg [amd64-shield]: https://img.shields.io/badge/amd64-yes-green.svg To install the **Akkudoktor-EOS** add-on in Home Assistant: • **Add the repository URL**: In Home Assistant, go to: and enter the URL of this Git repository: • **Install the add-on**: After adding the repository, the add-on will appear in the Add-on Store. Click **Install**. • **Start the add-on**: Once installed, click **Start** in the add-on panel. • **Access the dashboard**: Click **Open Web UI** in the add-on panel. • **Configure EOS** (optional): In the dashboard, go to: Docker (Recommended) Access the API at (docs at ) From Source **Linux:** **Windows:** Configuration EOS uses for configuration. If the file doesn't exist, a default configuration is created automatically. Custom Configuration Directory Configuration Methods • **EOSdash** (Recommended) - Web interface at • **Manual** - Edit directly • **API** - Use the Server API See the documentation for all configuration options. Port Configuration **Default ports**: 8503 (API), 8504 (Dashboard) If running on shared systems (e.g., Synology NAS), these ports may conflict with system services. Reconfigure port mappings as needed: API Documentation Interactive API docs available at: • Swagger UI: • OpenAPI Spec: View Online Resources • Full Documentation • Installation Guide (German) Contributing We welcome contributions! See CONTRIBUTING for guidelines. License This project is licensed under the Apache License 2.0 - see the LICENSE file for details.