Dynamic Climate is an advanced and explainable climate control system for Home Assistant, designed especially for high-inertia HVAC systems such as radiant floor heating and cooling.
Instead of reacting to temperature changes, Dynamic Climate anticipates them by dynamically calculating temperature setpoints based on thermal inertia, temperature trends, solar gains, ventilation impact and multiple safety constraints.
The result is stable comfort, reduced overshoot, improved efficiency and full traceability of every decision.
- Dynamic temperature setpoint calculation (not reactive control)
- Designed for high thermal inertia systems (radiant floors)
- Anticipation using temperature trends (°C/h)
- Solar gain and façade-aware logic
- Integration with mechanical ventilation systems (VMC)
- Strong safety layers (dew point, windows, sensor validation)
- Fully explainable and auditable decisions
- Scalable multi-zone architecture
- Designed to work with simple ON/OFF actuators
- ❌ Not a classic thermostat
- ❌ Not a PID controller
- ❌ Not a plug-and-play solution without understanding
- ❌ Not a system that modulates water flow or supply temperature
Dynamic Climate is a thermal decision engine that governs simple thermostats intelligently.
Dynamic Climate is built as a thermal decision pipeline, clearly separated into functional domains:
dc_common_*→ shared climate definitions and statisticsdc_<zone>_inputs→ configurable parameters (human control layer)dc_<zone>_core→ thermal calculation pipeline (the brain)dc_<zone>_automations→ application logic and safety handlingdc_<zone>_audit→ diagnostics, traceability and debug sensors
This separation ensures robustness, maintainability, scalability and full explainability.
Dynamic Climate implements a Hardware Abstraction Layer (HAL) through a dedicated HW map.
All physical sensors and actuators are referenced indirectly via mapping entities, allowing the system to be adapted to different installations without modifying any core logic.
To integrate Dynamic Climate into a new home, you only need to:
- map your real sensors and actuators in the HW map,
- keep the core calculation and automation files unchanged.
This design enables fast deployment, clean upgrades, safe refactoring and true portability between installations.
- Home Assistant (with
packagessupport) - Reliable indoor temperature sensors
- Outdoor temperature sensor (recommended)
- Humidity / dew point sensors (mandatory for cooling systems)
- ON/OFF climate control (radiant floor, radiators, etc.)
Optional but recommended:
- Solar / illuminance sensors
- Mechanical ventilation integration (VMC)
This project is released under the MIT License.
You are free to use, modify and distribute it, including for commercial purposes, provided that the original copyright and license are preserved.
Dynamic Climate is actively developed.
Current versions are released as RC (Release Candidate) iterations prior to a stable 1.0 release.
Dynamic Climate es un sistema avanzado y explicable de control climático para Home Assistant, diseñado especialmente para sistemas con alta inercia térmica, como la calefacción y refrigeración por suelo radiante.
En lugar de reaccionar a los cambios de temperatura, Dynamic Climate se anticipa, calculando consignas dinámicas en función de la inercia térmica, la tendencia de temperatura, la radiación solar, la ventilación y múltiples capas de seguridad.
El resultado es confort estable, menos sobreimpulsos térmicos, mayor eficiencia y decisiones totalmente trazables.
- Cálculo dinámico de consignas (no control reactivo)
- Diseñado para sistemas con alta inercia térmica
- Anticipación mediante tendencia térmica (°C/h)
- Lógica solar por fachadas
- Integración con ventilación mecánica (VMC)
- Capas sólidas de seguridad (rocío, ventanas, validación de sensores)
- Decisiones explicables y auditables
- Arquitectura multi-zona escalable
- Compatible con actuadores ON/OFF simples
- ❌ No es un termostato clásico
- ❌ No es un controlador PID
- ❌ No es plug-and-play sin comprensión previa
- ❌ No modula caudal ni temperatura de impulsión
Dynamic Climate es un motor de decisión térmica, no un actuador.
Dynamic Climate se estructura como un pipeline de decisión térmica, separado en dominios funcionales claros:
dc_common_*→ definiciones comunes de clima y estadísticasdc_<zona>_inputs→ parámetros configurablesdc_<zona>_core→ núcleo de cálculo térmicodc_<zona>_automations→ aplicación y lógica de seguridaddc_<zona>_audit→ auditoría, diagnóstico y trazabilidad
Esta separación garantiza robustez, mantenibilidad, escalabilidad y comprensión total del sistema.
Dynamic Climate utiliza una Capa de Abstracción de Hardware (HAL) mediante un HW map dedicado.
Todos los sensores y actuadores físicos se referencian de forma indirecta, lo que permite adaptar el sistema a distintas viviendas sin modificar el código núcleo.
Para integrar Dynamic Climate en una nueva instalación solo es necesario:
- mapear los sensores y actuadores reales en el HW map,
- mantener intactos los archivos de cálculo y automatización.
Este diseño permite despliegues rápidos, actualizaciones limpias, refactorización segura y verdadera portabilidad entre instalaciones.
- Home Assistant (con soporte de
packages) - Sensores fiables de temperatura interior
- Sensor de temperatura exterior (recomendado)
- Sensores de humedad / punto de rocío (obligatorios en refrescante)
- Control climático ON/OFF (suelo radiante, radiadores, etc.)
Opcional pero recomendable:
- Sensores solares / iluminancia
- Integración con ventilación mecánica (VMC)
Este proyecto se distribuye bajo licencia MIT.
Se permite su uso, modificación y distribución, incluso comercial, siempre que se conserve el aviso de copyright y la licencia original.
Dynamic Climate está en desarrollo activo.
Las versiones actuales se publican como RC (Release Candidate) antes de una versión estable 1.0.