ClimaSafe — Documentación técnica
Para desarrolladores e ingenieros. Documentación de integración, arquitectura y modelos. Si no eres técnico, usa la guía de usuario.
ClimaSafe es un sistema de aviso de riesgo cardiovascular por temperatura (calor / frío), personalizado por persona, ubicación, día y hora. Esta página es el punto de entrada a la documentación técnica: explica qué hace el sistema, cómo está construido y cómo se integra.
Qué hace el sistema
ClimaSafe estima un nivel de riesgo — SEGURO / PRECAUCIÓN / PELIGRO — ante el calor y el frío, para cualquier punto de España y para el día (u hora) elegido. El resultado combina:
- Un riesgo poblacional calculado por un ensemble de modelos de ML a partir de variables meteorológicas.
- Un riesgo individual que ajusta ese riesgo poblacional con los factores personales del usuario (edad, comorbilidades, medicación, aclimatación…).
Arquitectura
El flujo completo es:
datos meteorológicos → features → modelos → ensemble conformal → personalización → canales
- Datos: Open-Meteo en tiempo real, ERA5 para entrenamiento, AEMET/OpenUV y mortalidad MoMo como target.
- Features: índices de sensación térmica (Heat Index, WBGT, Wind Chill) y persistencia temporal.
- Modelos: ensemble de XGBoost (calor), RandomForest (frío) y una LSTM con embedding de provincia.
- Ensemble conformal: se combinan ponderando por el tamaño del conjunto de predicción conformal, con cobertura garantizada.
- Personalización: factores multiplicativos de la literatura epidemiológica.
- Canales: web, demo WebAssembly, bot de Telegram, servidor MCP y RAG.
Componentes y cómo se integran
| Canal | Qué ofrece | Enlace |
|---|---|---|
| Demo (WASM) | Pipeline completo en el navegador, sin servidor | probar-ya |
| Bot de Telegram | Alertas diarias y consultas de riesgo | telegram.html |
| Servidor MCP | Acceso al motor de riesgo desde asistentes de IA | mcp.html |
| Repositorio | Código, modelos, datos y tests | ANFAIA/ClimaSafe |
Documentación técnica por tema
| Página | Qué explica |
|---|---|
| Modelos y pesos | Los 4 modelos + la fórmula, cómo se combinan (ensemble conformal), métricas, umbrales, el modelo bayesiano de contraste y los factores individuales con su peso. |
| Riesgo y personalización | Índices de sensación térmica y la tabla completa de factores individuales con su peso y su fuente. |
| Arquitectura | El flujo completo: datos → features → modelos → ensemble → personalización → canales (web, demo, bot, MCP, RAG). |
| Papers | La base científica: guías y estudios que sustentan índices, factores y umbrales. |
| LLM | El papel del LLM (redacción, no predicción), modelos soportados, fine-tuning, RAG y hosting remoto gratuito. |
Documentación interna del proyecto
La documentación completa (notas internas, decisiones, actas) vive en el repositorio:
documentacion/.
Licencia
ClimaSafe está publicado bajo Apache 2.0: se puede usar, modificar y distribuir libremente, incluso comercialmente, conservando el aviso de licencia.
ClimaSafe se desarrolló como parte de las ANFAIA Summer Grants 2026.