AI-powered control for Nibe heat pumps using Claude API.
NibePilot uses artificial intelligence to optimize your Nibe exhaust air heat pump for comfort and energy efficiency.
- AI-Powered Analysis: Uses Claude API to analyze sensor data and weather forecasts
- Adaptive Control: Automatically adjusts heat curve and offset based on conditions
- Weather Integration: Uses weather forecasts to predict heating needs
- Electricity Price Support: Optional integration with Nordpool for cost optimization
- Safe Operation: Conservative limits and confidence thresholds prevent drastic changes
- Transparent Decisions: View AI reasoning and recommendations in Home Assistant
- Home Assistant 2024.1.0 or newer
- Nibe heat pump with ESPNibe or similar integration
- Claude API key from Anthropic
- Open HACS in Home Assistant
- Click the three dots in the top right corner
- Select "Custom repositories"
- Add this repository URL and select "Integration"
- Search for "NibePilot" and install
- Restart Home Assistant
- Download this repository
- Copy
custom_components/nibe_pilotto yourconfig/custom_components/directory - Restart Home Assistant
- Go to Settings > Devices & Services
- Click "Add Integration"
- Search for "NibePilot"
- Follow the configuration wizard:
- Enter your Claude API key
- Set update interval (5-60 minutes)
- Select temperature sensors (outdoor, indoor, supply)
- Select control entities (heat curve, offset)
- Optionally add weather and electricity price entities
| Entity | Type | Description |
|---|---|---|
switch.nibe_pilot_auto_mode |
Switch | Enable/disable automatic control |
sensor.nibe_pilot_recommendation |
Sensor | Current AI recommendation |
sensor.nibe_pilot_analysis |
Sensor | AI analysis and reasoning |
sensor.nibe_pilot_confidence |
Sensor | Confidence level (0-100%) |
sensor.nibe_pilot_last_action |
Sensor | Last action taken |
- NibePilot collects data from your configured sensors
- It fetches weather forecasts and optionally electricity prices
- All data is sent to Claude API for analysis
- The AI returns a recommendation with confidence level
- If auto-mode is enabled and confidence is above threshold, changes are applied
- All decisions are logged and visible in Home Assistant
- Auto-mode disabled by default: You must explicitly enable automatic control
- Confidence threshold: Only recommendations with >70% confidence are applied
- Limited adjustments: Heat curve changes limited to +/-5, offset to +/-3
- Transparent operation: All AI decisions and reasoning are visible
- Outdoor temperature (BT1)
- Indoor temperature (BT50 or similar)
- Supply/flow temperature (BT2)
- Return temperature (BT3)
- Compressor frequency
- Power consumption
- Hot water temperature (BT6/BT7)
For automatic control, configure at least one of:
- Heat curve (number or input_number entity)
- Heat offset (number or input_number entity)
- Temperature setpoint (climate or number entity)
Any Home Assistant weather integration works. The integration uses the forecast attribute.
Supports Nordpool integration. Uses raw_today and raw_tomorrow attributes for hourly prices.
- Sensor data is sent to Claude API for analysis
- No personal information beyond sensor readings is transmitted
- Claude API has its own privacy policy: https://www.anthropic.com/privacy
Ensure your Claude API key is correct and has sufficient credits.
Check that all required sensors are reporting valid values.
Verify auto-mode is enabled and control entities are configured correctly.
MIT License - See LICENSE file for details.
Contributions are welcome! Please submit issues and pull requests on GitHub.