Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/elenacarino-max/mas-climapp/llms.txt

Use this file to discover all available pages before exploring further.

ClimApp is a web application for real-time meteorological monitoring in the Community of Madrid. It uses GPS-based geolocation to find your nearest official AEMET weather station and delivers live readings on temperature, humidity, wind, pressure, and precipitation — along with an intelligent alert system and tools to log, query, and compare your own measurements.

Quick Start

Get ClimApp running locally in minutes with step-by-step setup instructions.

Configuration

Set up your AEMET API key and environment variables to connect to live data.

API Reference

Explore all endpoints — real-time weather, manual records, history, and comparison.

Architecture Overview

Understand ClimApp’s layered architecture and how data flows through the system.

Core features

Real-Time Weather

GPS-powered weather lookup using the Haversine formula to find your nearest AEMET station.

Manual Logging

Record measurements from your own weather station and store them in JSON and SQLite.

Historical Data

Browse, filter, and audit all stored climate records by municipality and date.

AEMET Comparison

Compare your manual readings against official AEMET data to validate accuracy.

Getting started

1

Clone the repository

Clone the project and set up a Python virtual environment on your machine.
2

Configure your AEMET API key

Create a .env file with your free AEMET OpenData API key and a session secret key.
3

Install dependencies and run

Install packages from requirements.txt and start the Flask development server.
4

Open the dashboard

Navigate to http://localhost:5000 and allow location access to see live weather data.
ClimApp requires a free API key from AEMET OpenData to fetch real-time weather observations. See Configuration for setup details.

Build docs developers (and LLMs) love