Spaces:
Running
Running
| 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 |