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 runs as a standard Flask application and has no external service dependencies beyond a free AEMET OpenData API key. The setup below takes you from an empty directory to a running server at http://localhost:5000, where ClimApp will ask your browser for location access so it can identify the nearest official weather station.
You need a free AEMET API key before starting. Register at opendata.aemet.es — the key is issued instantly after email verification and gives full access to the observation endpoints ClimApp uses.
1

Clone the repository

git clone https://github.com/elenacarino-max/mas-climapp.git && cd mas-climapp
2

Create and activate a virtual environment

A virtual environment keeps ClimApp’s dependencies isolated from your system Python installation.
python -m venv venv
source venv/bin/activate
3

Install dependencies

With the virtual environment active, install all required packages from requirements.txt:
pip install -r requirements.txt
The file installs the following packages:
requirements.txt
# Servidor y Web
flask
gunicorn

# Variables de entorno
python-dotenv

# Comunicación y API
requests

# Tareas automáticas (Scheduler)
flask-apscheduler

# Análisis de datos
pandas
openpyxl

# Tests y calidad
pytest
4

Configure environment variables

Create a .env file in the project root. ClimApp reads this file at startup using python-dotenv.
.env
AEMET_API_KEY=your_api_key_here
SECRET_KEY=your_secret_key_here
Replace your_api_key_here with the key from the AEMET portal and your_secret_key_here with a long random string used to sign Flask sessions. See the configuration guide for details on both variables.
5

Start the development server

python app.py
The server starts in debug mode and binds to all interfaces on port 5000. You should see Flask’s standard startup output confirming it is running.
6

Open ClimApp in your browser

Navigate to http://localhost:5000 and grant location access when prompted. ClimApp uses your browser’s Geolocation API to determine which AEMET monitoring station is closest to you, then fetches live weather data automatically.
Run python -m pytest from the project root to execute the full test suite and verify that services, controllers, and repositories are all working correctly before using the application with real data.

Build docs developers (and LLMs) love

Get started for freeTalk to us