EcoEdge

Getting started: connect Home Assistant to EcoEdge

EcoEdge reads your climate entities through a Home Assistant custom integration, builds a thermal model of every room, and shows heat loss, temperature predictions, and setpoint recommendations on this dashboard. Setup takes about ten minutes; the models need a day or two of data before the first results appear.

What you need

  • A running Home Assistant installation with at least one climate entity (thermostat, TRV, heat-pump controller, or floor-heating zone)
  • HACS (Home Assistant Community Store) for the one-click install
  • An outdoor temperature sensor is a plus but not required — EcoEdge falls back to hourly forecast data for your coordinates

Step 1 — create your EcoEdge account

Sign up free with your email. Set your home's location during registration — the weather forecasts that drive predictions are fetched for your exact coordinates.

Step 2 — install the integration via HACS

  1. Open HACS in Home Assistant → Integrations → three-dot menu → Custom repositories.
  2. Add https://github.com/ecoedge-dev/ha_ecoedge_ai_thermostat with category Integration.
  3. Download EcoEdge AI Thermostat and restart Home Assistant.

Step 3 — connect and choose your thermostats

  1. Settings → Devices & Services → Add Integration → search for "EcoEdge AI Thermostat".
  2. Sign in with the same email and password as your dashboard account.
  3. Select the climate entities you want modeled, and an outdoor temperature sensor if you have one. Submit.

From this moment the integration forwards climate state changes (current temperature, target, heating action) to EcoEdge. Your home appears on the dashboard as soon as the first data batch arrives.

Step 4 — let it learn

The physics models fit from your data automatically — there is nothing to configure. Rough timeline:

After You'll see
Minutes Your home and thermostats listed on the dashboard
A few hours First temperature history charts
1–2 days Measured heat-loss (k) per room with confidence scores
A few days 24-hour predictions and setpoint recommendations

What you get back in Home Assistant

The integration also creates sensor entities on the HA side — AI recommended setpoint, active model, heat-loss value, confidence, and estimated saving — so you can build your own automations and dashboards on top of EcoEdge's models. Recommendations are advisory by design: EcoEdge never changes your thermostats; what you automate with the sensors is up to you.

Frequently hit snags

  • Home not appearing? Check the integration's credentials match your dashboard account, and that the selected entities actually change state (a thermostat that never reports produces no data).
  • Heat loss shows low confidence? Normal in the first days, and in summer when heating rarely runs — confidence grows with every heating cycle and cool-down the model observes.
  • Multiple homes? Each Home Assistant instance connects with its own account home; the dashboard lists them side by side.

Questions beyond this guide: see the Help & FAQ page.