README.md

---
title: SentinelOne
emoji: 🛰️
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
license: mit
short_description: AI Agents for climate risk assessment and monitoring
---

# 🛰️ SentinelOne – Climate Risk Assessment Platform

Welcome to our submission for the **Hugging Face GenAI Agents & MCP Hackathon**!  
This project showcases **a multi-agent system** powered by **Gradio** and **Smolagents**, designed to monitor, process, and analyze environmental data to **assess climate-related risks and provide recommendations**.
Link to demo : https://youtu.be/aLK_HUSRl4w
---
 
## 🚨🟡🌍 **IMPORTANT NOTICE FOR HACKATHON!** 🤖🛰️🚨

🏆 **If our project wins a prize at the hackathon, we will use the award to purchase additional API credits so we can continue development and maintain the Agents for everyone.** 🏆

🙏 Your support will directly contribute to making this open-source climate risk platform sustainable and accessible! 🙏

💚 **Thank you for your trust and your votes!** 💚

---

## 🌐 Project Overview

This system leverages autonomous agents that collaborate to perform complex data science workflows:

- 🛰️ **Risk Assessment Agent**: Analyzes environmental data and assesses potential climate-related risks.
- 📊 **Recommendation Agent**: Provides actionable recommendations based on risk assessments.
- 🎯 **Orchestrator**: Coordinates the workflow (deterministic for now) between different agents and tools.

---

## 🗂️ Data Sources & External APIs

Our platform relies on **real, authoritative, and up-to-date environmental data sources**. Each data stream is directly queried and processed by dedicated AI tools, enabling both precise geolocation and a truly holistic risk assessment.  
**Here is a detailed overview of the APIs and data sources leveraged by the agents:**

### 1. **OpenStreetMap – Geolocation & Mapping**
- **Purpose:** Converts city names or user input into precise latitude/longitude coordinates.
- **API Used:** [Nominatim API](https://nominatim.org/release-docs/develop/api/Search/)
- **Usage:** All risk assessments start by locating the point of interest. This is the backbone for all downstream weather, risk, and local resource queries.

### 2. **Open-Meteo – Weather, Climate, Marine & Flood Data**
A suite of APIs offering a wide spectrum of meteorological and environmental data:
- **Current & Forecasted Weather:**  
  - `api.open-meteo.com/v1/forecast`  
  - Daily/weekly forecasts: temperature, precipitation, wind, humidity.
- **Historical Weather:**  
  - `archive-api.open-meteo.com/v1/archive`  
  - Up to 50 years of daily meteorological records for any coordinate.
- **Climate Change Projections:**  
  - `climate-api.open-meteo.com/v1/climate`  
  - Multi-model climate projections (1950–2050), covering temperature, rainfall, humidity, wind, radiation, soil moisture, etc.
- **Flood Risk:**  
  - `flood-api.open-meteo.com/v1/flood`  
  - River discharge, flood probability, and trends, updated daily.
- **Marine & Coastal Data:**  
  - `marine-api.open-meteo.com/v1/marine`  
  - Daily oceanic conditions: wave heights, swell, periods, and wind on sea.
- **Satellite Solar Radiation:**  
  - `satellite-api.open-meteo.com/v1/archive`  
  - Hourly solar and terrestrial radiation from satellite observation.
- **Air Quality:**  
  - `air-quality-api.open-meteo.com/v1/air-quality`  
  - Hourly PM10, PM2.5, CO, NO2, SO2, ozone, pollen, and AQI.

**Open-Meteo** is open, reliable, and integrates data from a variety of meteorological institutes.

### 3. **USGS – Earthquake Data**
- **Purpose:** Provides real-time and historical seismic activity near a given location.
- **API Used:** [USGS Earthquake Catalog API](https://earthquake.usgs.gov/fdsnws/event/1/)
- **Usage:** Retrieves all seismic events (magnitude, time, depth, location) in a configurable radius and time window (default: last 30 days, within 100 km).

### 4. **NASA FIRMS – Wildfire Detection**
- **Purpose:** Detects active wildfires using data from earth observation satellites.
- **API Used:** [NASA FIRMS (Fire Information for Resource Management System)](https://firms.modaps.eosdis.nasa.gov/)
- **Data:** MODIS & VIIRS satellite observations, real-time fire detections (location, brightness, confidence, time, etc.).
- **Authentication:** Requires a NASA FIRMS API key (set in `.env`).
- **Usage:** All fire events in the last 2 days within a given radius (default: 50km) of the query point.

### 5. **OpenStreetMap – Local Emergency Resources**
- **Purpose:** Finds nearest hospitals, fire stations, and police stations for a given location.
- **API Used:** [Overpass API](https://wiki.openstreetmap.org/wiki/Overpass_API)
- **Usage:** Critical for vulnerability assessment and emergency preparedness, especially in high-risk areas.

---

## 📦 Data Integration Logic

All data is retrieved in real time and cross-referenced using geospatial coordinates. The system is designed to:
- Query and aggregate up-to-date meteorological, geophysical, and environmental signals
- Offer long-term context (climate, trends) and immediate alerts (fire, flood, quake, air pollution)
- Provide geographic context: local emergency resources and infrastructural exposure
- Output both raw data and actionable visualizations (charts, maps, PDF reports)

**Example API calls in our workflow:**
- 🌦️ Weather: Open-Meteo
- 🔥 Wildfire: NASA FIRMS
- 🌊 Flood: Open-Meteo Flood API
- 🌐 Mapping & Resources: OpenStreetMap Nominatim & Overpass
- 🌍 Seismic: USGS
- 🏭 Air Quality: Open-Meteo Air Quality API
- 🏝️ Marine and coastal data: Open-Meteo Marine API
- ☀️ Solar radiations: Open-Meteo Satellite API
- 📈 Climate Change: Open-Meteo Climate API

---

## 🧩 Core Components

### 👁️ Risk Assessment Agent (`risk_agent.py`)
- **Role:** Analyzes environmental data and assesses risks
- **Responsibilities:**
    - Process environmental data
    - Evaluate risk levels
    - Generate risk reports

### 🧠 Recommendation Agent (`recommendation_agents.py`)
- **Role:** Provides actionable recommendations
- **Responsibilities:**
    - Analyze risk assessments
    - Generate tailored recommendations
    - Prioritize actions

### 🔧 Tools (`tools.py`)
- Data processing utilities
- Mapping utilities (`mapping_utils.py`)
- Configuration management (`config.py`)

### 🎨 User Interface (`ui.py`)
- Interactive Gradio interface
- Real-time data visualization
- User-friendly controls

---

## 🧑‍💻 Authors

- Tristan DARRIGOL – AI Consultant @Wavestone
- Clément PEPONNET – AI Agents engineer @Wavestone
- Paul BARBASTE – AI Agents architect @Wavestone & AI Researcher @Inclusive Brains
 

---

## 📝 License

This project is licensed under the MIT License