Skip to content

Installation

This guide will help you install the Heating Curve Optimizer integration in Home Assistant.

Prerequisites

Before installing, ensure you have:

  • ✅ Home Assistant 2023.1 or newer
  • ✅ HACS (Home Assistant Community Store) installed
  • ✅ Internet connectivity (for weather forecasts from open-meteo.com)
  • ✅ Electricity price sensor (or fixed price configuration)

Installation Methods

  1. Open HACS in your Home Assistant instance
  2. Click on "Integrations"
  3. Click the three dots in the top right corner
  4. Select "Custom repositories"
  5. Add this repository: 
    https://github.com/bvweerd/heating_curve_optimizer
  6. Select "Integration" as the category
  7. Click "Add"
  8. Search for "Heating Curve Optimizer"
  9. Click "Download"
  10. Restart Home Assistant

Method 2: Manual Installation

  1. Download the latest release from GitHub Releases
  2. Extract the zip file
  3. Copy the custom_components/heating_curve_optimizer directory to your Home Assistant custom_components directory
  4. Restart Home Assistant

Your directory structure should look like: 

config/
├── custom_components/
│   └── heating_curve_optimizer/
│       ├── __init__.py
│       ├── sensor.py
│       ├── config_flow.py
│       └── ...

Initial Configuration

After installation and restart:

  1. Navigate to Settings → Devices & Services
  2. Click "+ Add Integration"
  3. Search for "Heating Curve Optimizer"
  4. Follow the configuration wizard (see Configuration Guide)

Verifying Installation

After configuration, you should see 17 new sensors and 5 number entities:

Sensors

  • sensor.heating_curve_optimizer_outdoor_temperature
  • sensor.heating_curve_optimizer_heat_loss
  • sensor.heating_curve_optimizer_window_solar_gain
  • sensor.heating_curve_optimizer_net_heat_loss
  • sensor.heating_curve_optimizer_heating_curve_offset (main optimization output)
  • And 12 more...

Number Entities (Manual Controls)

  • number.heating_curve_optimizer_offset - Manual offset override
  • number.heating_curve_optimizer_min_supply_temp
  • number.heating_curve_optimizer_max_supply_temp
  • number.heating_curve_optimizer_min_outdoor_temp
  • number.heating_curve_optimizer_max_outdoor_temp

Check Sensor States

After a few minutes, check that the sensors show actual values (not "unavailable"). If sensors are unavailable, check the Troubleshooting Guide.

Next Steps

Updating

Via HACS

  1. Open HACS
  2. Navigate to Integrations
  3. Find "Heating Curve Optimizer"
  4. Click "Update" if available
  5. Restart Home Assistant

Manual Update

Follow the same steps as manual installation, replacing existing files.

Breaking Changes

Check the Release Notes for any breaking changes before updating.

Uninstallation

To remove the integration:

  1. Navigate to Settings → Devices & Services
  2. Find "Heating Curve Optimizer"
  3. Click the three dots
  4. Select "Delete"
  5. Optionally remove the integration files from custom_components/
  6. Restart Home Assistant

Next: Configuration Guide - Learn how to configure your building parameters