README.md

metadata

title: ClimateGuard
emoji: ⚡
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
  - streamlit
pinned: false
short_description: AI‑powered personal climate risk and livability forecast.
license: mit

Welcome to Streamlit!

Edit /src/streamlit_app.py to customize this app to your heart's desire. :heart:

If you have any questions, checkout our documentation and community forums.

ClimateGuard AI

Tagline: AI‑powered personal climate risk and livability forecast for the next decade — for individuals, businesses, and governments.

ClimateGuard AI turns overwhelming climate and weather data into clear, actionable guidance: livability scores, early hazard alerts, and safe relocation suggestions. Built for a hackathon demo and ready to deploy on Hugging Face Spaces with Streamlit.

---

✨ Demo Highlights (5‑minute flow)

1. Climate Risk Snapshot — Enter a city; see a 14‑day risk outlook and a 12‑month livability calendar (projected using climatology + heuristics).
2. Scenario Compare — "What if I move to Cape Town in 2029?" Side‑by‑side risk comparison across locations.
3. Alert Simulation — Trigger a flood/heat alert and get actionable, location‑aware guidance.
4. Business View — Upload branches with lat/lon; get a risk heatmap and branch‑level mitigation steps.

⚠️ Note: This project does not claim to be a GCM/RCM climate model. It integrates data from weather/climate APIs and runs a transparent heuristic risk model designed for hackathon speed & interpretability.

---

🧱 Architecture

• Streamlit UI: app.py
• Data providers: src/data_providers.py
• Risk model: src/risk_model.py
• Utilities: src/utils.py
• Sample data: data/sample_branches.csv