ha-intuihems

intuiHEMS - Smart Battery Optimizer

English below

hacs_badge GitHub Release

Spare Stromkosten & reduziere CO₂ - Dein Batteriespeicher wird automatisch zum optimalen Zeitpunkt gesteuert.

intuiHEMS ist ein Smart Battery Optimizer für Home Assistant. Es optimiert deinen Heimspeicher anhand dynamischer Strompreise, Solarprognosen und deines Verbrauchs vollautomatisch.

✨ Das sind die Vorteile

🧠 Wie intuiHEMS deinen Speicher optimiert

intuiHEMS erkennt deinen Batteriespeicher, deine PV-Anlage und den Hausverbrauch automatisch, ganz ohne aufwendige Einrichtung.

Mithilfe KI-gestützter Prognosen berechnet das System bis zu 24 Stunden im Voraus, wie sich Stromverbrauch, Solarertrag und Strompreise entwickeln. Auf dieser Basis wird alle 15 Minuten ein optimaler Lade- und Entladeplan erstellt.

So wird dein Speicher genau dann geladen oder genutzt, wenn es wirtschaftlich und ökologisch sinnvoll ist. In deinem Home-Assistant-Dashboard siehst du jederzeit, wie viel Geld und CO₂ du dadurch einsparst.

Deine Daten bleiben dabei vollständig in deiner Kontrolle und werden nicht an Dritte weitergegeben.

⚠️ Alpha-Version

intuiHEMS befindet sich aktuell in der Alpha-Phase. Die Kernfunktionen sind stabil, dennoch können vereinzelt Bugs auftreten.

Während der Alpha-Phase ist das Plugin kostenlos und auf 100 Tester limitiert. Feedback aus der Community spielt dabei eine zentrale Rolle. Wenn Ihr dabei sein wollt, schreibt eine kurze Nachricht in das Diskussionsforum mit der Beschreibung eures Systems: welche Batterie, Wechselrichter, dyn. Stromtarif.

📋 Voraussetzungen

intuiHEMS funktioniert, wenn folgende Punkte erfüllt sind:

🚀 Installation

1. Über HACS installieren

HACS → Integrationen → „intuiHEMS” suchen → Installieren

2. Integration hinzufügen

Einstellungen → Geräte & Dienste → intuiHEMS

3. Fertig ✨

Dein Batteriespeicher wird jetzt automatisch optimiert.

Hinweis: Systeme die nicht automatisch erkannt werden, können manuell angebunden werden.

Mit ❤️ für die Home Assistant Community

intuiHEMS - Smart Battery Optimizer

hacs_badge GitHub Release

Save money. Save the planet. Automatically optimize your home battery to use cheap renewable energy and reduce grid strain.

🌍 Why intuiHEMS?

Climate change demands smarter energy use. intuiHEMS helps you:

✨ Key Features

🚀 Quick Start

  1. Install via HACS
    • HACS → Integrations → Explore & Download Repositories
    • Search “intuiHEMS”
    • Install & Restart
  2. Add Integration
    • Settings → Devices & Services → Add Integration
    • Search “intuiHEMS”
    • Click through setup - we auto-detect everything!
  3. Done! ✨
    • Your battery is now optimized 24/7
    • Check savings in your dashboard

📋 Requirements

🎯 What Gets Optimized?

Before intuiHEMS:

With intuiHEMS:

🧠 How It Works

  1. Every 15 minutes: Reads your battery level, house consumption, solar production
  2. AI forecasts: Predicts next 24 hours of consumption, solar, and prices
  3. Optimization: Calculates the perfect battery schedule
  4. Execution: Tells your battery when to charge/discharge

All the heavy AI computation happens in the cloud - works on any Home Assistant device!

🎬 Supported Devices

Auto-detected (zero config):

Learning system:

⚠️ Alpha Status

Current Version: 2025.11.9.1

This is an alpha release. What this means:

Your feedback shapes the product!

📊 What You Get

Alpha Testing Program

What to Expect

Status: Alpha (v0.1.0)

How to Report Issues

  1. Check existing GitHub Issues
  2. Create new issue with:
    • Home Assistant version
    • Integration version
    • Battery/inverter model
    • Detailed description of problem
    • Relevant logs from Settings → System → Logs

Alpha User Limit

The cloud service currently supports 100 alpha users. To check availability:

curl https://api.intuihems.io/api/v1/auth/status

Response:

{
  "status": "accepting_users",
  "current_users": 45,
  "max_users": 100,
  "alpha_phase": true
}

Privacy & GDPR

Data Collection

intuiHEMS collects:

Data Usage

Your data is used for:

Your Rights (GDPR)

Right How to Exercise
Access (Article 15) Settings → intuiHEMS → Export Data
Rectification (Article 16) Settings → intuiHEMS → Update Configuration
Erasure (Article 17) Settings → intuiHEMS → Delete Account
Data Portability (Article 20) Settings → intuiHEMS → Export Data (JSON)

Data is never shared with third parties. Data retention: 30 days (configurable).

Privacy Policy

Full privacy policy: https://api.intuihems.io/api/v1/gdpr/privacy

🆘 Need Help?

Technical Details

Architecture

Update Frequency

Task Frequency
Sensor data upload Every 15 minutes
Price fetching Every hour
Consumption/solar forecasts Every 2 hours
MPC optimization Every 15 minutes
Control plan fetch Daily at 00:05
Control execution :00, :15, :30, :45 minutes

Data Storage

Development

Local Development

# Clone repository
git clone https://github.com/intui/intuiHEMS.git
cd intuiHEMS

# Create development environment
python3 -m venv venv
source venv/bin/activate
pip install -e .

# Run tests
pytest tests/

Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create feature branch
  3. Add tests
  4. Submit pull request

See CONTRIBUTING.md for details.

Roadmap

v0.2.0 (Beta)

v1.0.0 (Stable)

v2.0.0 (Future)

Support the Project

intuiHEMS is free during alpha testing. If it saves you money, please consider donating to support development:

Suggested donation: 20% of monthly electricity savings

License

This project is licensed under the BSD-3-Clause License - see LICENSE file for details.

Acknowledgments

Made with ❤️ for the Home Assistant community

This site is open source. Improve this page.