⚡ Open HEMS — Autonomous Home Energy Management System

Autonomous, economic, and grid-aware Home Energy Management System (HEMS) for Home Assistant.
Native support for the Belgian market (Fluvius digital meter, Capacity Tariff peak-shaving, dynamic Belpex spot tariffs), with an extensible European Market Adapter architecture (Netherlands, Germany, EU Spot).

---

👵 Live Senior & Family Energy Advisor (WCAG AAA)

Looking for an ultra-simple, accessible energy switch calculator for seniors, parents, or family members without any technical jargon? 👉 Test the live public advisor: hems-cfo-dashboard.vercel.app/advies
(Also accessible via /eenvoudig). Features extra-large typography, 1-click WhatsApp family sharing, and 100% independent tariff calculations.

---

🌍 Regional Market Adapters & European Roadmap

Energy grids across Europe are shifting from flat rates to dynamic tariffs and capacity-based network costs. Open HEMS is structured around plug-and-play Market Adapters:

Country / Region	Grid & Meter Standard	Tariff & Optimization Focus	Status
🇧🇪 Belgium (Flanders)	Fluvius P1 Digital Meter (DSMR)	Capaciteitstarief (Peak Shaving < 3.15 kW) + Belpex Spot Tariffs & Solar Injection	🟢 Production
🇳🇱 Netherlands	DSMR P1 Slimme Meter (HomeWizard / SlimmeLezer)	Terugleverkosten Shaving + EPEX Spot (Tibber / ANWB) + Netcongestie Buffer	🟡 Adapter Ready
🇩🇪 Germany	Smart Meter Gateway / Pulse	§14a EnWG Controllable Consumers (Heat Pump / EV Dimming) + Dynamic EPEX	🟡 Adapter Ready
🇪🇺 EU / Nordics	Generic P1 / MQTT / Modbus	Nord Pool / Day-Ahead Hourly Optimization + Self-Consumption Boost	🟢 Production

🌐 Multilingual Advisory Roadmap (i18n): With regional market adapters active across Belgium, Netherlands, Germany, and the EU, the public Senior & Family Energy Advisor (/advies) is slated for native multi-language support:

• 🇳🇱 Nederlands (NL/BE): Active (Vlaanderen & Nederland)
• 🇫🇷 Français (FR/BE): In development (Wallonie, Bruxelles & France)
• 🇩🇪 Deutsch (DE): In development (Deutschland & Ostbelgien)
• 🇬🇧 English (EN): In development (Universal EU / Nordics)

---

🏛️ Architecture & Hardware Abstraction

Open HEMS decouples your physical meters and country-specific rules via a Hardware Abstraction Layer (HAL):

flowchart TD
    subgraph Hardware["1. Physical Hardware (Universal)"]
        P1["P1 Digital Meter (HomeWizard / SlimmeLezer / DSMR)"]
        PV["Solar Inverter (SolarEdge / SMA / Enphase / Huawei / Growatt)"]
        GAS["Gas Meter (P1 Gas Channel / HomeWizard Gas / Pulse)"]
        CLIM["HVAC (Heat Pumps / Gas Condensing Boilers / Thermostats)"]
    end

    subgraph HAL["2. HEMS Hardware Abstraction Layer"]
        G_IMP["hems_grid_import_power"]
        G_EXP["hems_grid_export_power"]
        S_SOL["hems_solar_power_current"]
        C_HOU["hems_household_consumption_power"]
    end

    subgraph Markets["3. Regional Market Adapters"]
        BE["🇧🇪 Belgium: Fluvius Capacity Tariff + Belpex Spot"]
        NL["🇳🇱 Netherlands: DSMR + Terugleverkosten + EPEX"]
        DE["🇩🇪 Germany: §14a EnWG Dimming + EPEX Spot"]
        EU["🇪🇺 Generic EU: Nord Pool Day-Ahead Spot"]
    end

    subgraph Engine["4. Optimization & AI Agent Skill"]
        PEAK["Peak Shaving Engine (<3.15 kW drempel)"]
        DISP["Smart Appliance Solar Dispatcher (Vaatwasser/Droogkast)"]
        AI["Google Antigravity & AI Agent Skill (.agents/skills/)"]
    end

    Hardware --> HAL
    HAL --> Markets
    Markets --> Engine

Loading

---

📦 What's Included?

1. packages/hems/00_hems_hardware_abstraction.yaml
   Standardizes grid import/export, solar, and consumption entities into clean, normalized sensors.
2. packages/hems/10_hems_capacity_tariff.yaml
   Tracks 15-minute rolling average peak power to prevent costly Fluvius capacity tariff surcharges.
3. packages/hems/20_hems_smart_appliances.yaml
   Intelligently delays heavy appliances (dishwasher, washing machine, heat pump) to solar production valleys or low-tariff hours.
4. skills/hems-agent/SKILL.md
   Universal agent skill that allows any AI coding assistant to auto-discover your hardware and manage your energy setup.
5. scripts/discover_entities.py
   Automated Python discovery tool that queries your Home Assistant REST API and maps your local sensors.

---

🚀 Quick Start (in 3 Minutes)

Step 1: Copy Packages to Home Assistant

Copy the packages/hems/ directory into your Home Assistant /config/packages/ folder. Ensure your configuration.yaml includes packages:

homeassistant:
  packages: !include_dir_named packages

Step 2: Auto-Discover Your Entities

Run the discovery script to detect your local sensors:

export HA_URL="http://homeassistant.local:8123"
export HA_TOKEN="your_long_lived_access_token_here"
python3 scripts/discover_entities.py

Step 3: Reload Home Assistant Core

Reload your template entities via Developer Tools > YAML > Reload Template Entities or run:

ha core reload

---

🤖 AI Agent-Driven Smart Home Management (Google Antigravity & Beyond)

Managing a modern smart home with dynamic energy prices, capacity tariffs, solar forecasts, and HVAC thermal inertia is too complex for manual YAML configuration.

Open HEMS is built natively for AI Pair-Programming with Google Antigravity (AGY) and modern agentic coding environments (Claude Code, Cursor, Windsurf, Copilot Workspace). Instead of writing template sensors by hand, you delegate the heavy lifting to your AI coding agent.

       ┌────────────────────────────────────────────────────────┐
       │                Your High-Level Goal                    │
       │  "Optimize my home for Fluvius capacity tariff and     │
       │   switch my heat pumps to solar surplus dispatching."  │
       └───────────────────────────┬────────────────────────────┘
                                   │
                                   ▼
       ┌────────────────────────────────────────────────────────┐
       │               Google Antigravity Agent                 │
       │   • Reads `.agents/skills/hems-agent/SKILL.md`         │
       │   • Auto-discovers physical meters via HA REST API     │
       │   • Maps entities to the Hardware Abstraction Layer    │
       │   • Configures automations & runs `ha core check`      │
       └───────────────────────────┬────────────────────────────┘
                                   │
                                   ▼
       ┌────────────────────────────────────────────────────────┐
       │                 Home Assistant Core                    │
       │     Active, Self-Balancing Economic Energy Engine      │
       └────────────────────────────────────────────────────────┘

1. How to use with Google Antigravity (AGY)

The repository includes a ready-to-use skill in .agents/skills/hems-agent/SKILL.md.

1. Open your Home Assistant workspace in Google Antigravity.
2. Clone or add Open HEMS to your workspace.
3. Prompt Antigravity:

   Read the hems-agent skill and inspect my Home Assistant setup.
   Connect my P1 meter and solar inverter to the HEMS Hardware Abstraction Layer.
   

4. Use Slash Commands for Deep Optimization:
   • /plan: "Draft an economic comparison of my current energy contract against Belgian fixed vs. variable market deals."
   • /goal: "Autonomously audit my white goods scheduling, eliminate morning peak-hour triggers, and verify condensing boiler efficiency."

---

2. Example Prompts for Any AI Coding Assistant

Whether you use Google Antigravity, Claude Code, or Cursor, you can copy-paste these turnkey instructions:

• Hardware Discovery & Setup:

  "Inspect my configuration.yaml and entity states. Map my physical smart meter (sensor.p1_*) and solar inverter (sensor.solaredge_* / sensor.huawei_*) to packages/hems/00_hems_hardware_abstraction.yaml."

• Belgian Capacity Tariff Guard:

  "Analyze my historical peak power demand in Home Assistant. Set up a warning threshold at 3.15 kW and write an automation to pause heavy loads when grid power approaches this limit."

• HVAC Thermal Inertia Tuning:

  "Review my heating topology. Enforce a minimum comfort baseline of 20.0°C on hydronic floor heating to prevent thermal mass loss, while utilizing rapid heat pumps for midday solar pre-heating."

---

📄 License & Community

Released under the MIT License. Maintained with ❤️ by the HEMS Lab community.

• 💬 Discussions & Feedback: Open a GitHub Issue or join the conversation on the Home Assistant Community Forum.
• ✉️ Contact: [email protected]