🌍 Climate Shield

AI-driven real-time climate risk analysis platform for detecting flood and heatwave threats using live weather intelligence.

---

🚀 Live Demo

🌐 https://climate-shield.onrender.com

---

📌 Overview

Climate Shield is a lightweight climate intelligence platform that combines:

• 🌦 Real-time weather monitoring
• ⚠ Flood and heatwave risk analysis
• 🤖 AI-powered climate awareness chatbot
• 📊 Modern analytics dashboard
• 🌍 Location-based weather insights

Users can enter:

• City
• State
• Country

and instantly receive:

• Live weather data
• Flood risk score
• Heatwave risk score
• Climate alerts
• Safety guidance

---

✨ Features

🌦 Real-Time Weather Monitoring

Climate Shield fetches live weather data using the OpenWeatherMap API and displays:

• Temperature
• Humidity
• Rainfall
• Wind Speed

---

⚠ Climate Risk Analysis

The backend computes:

Flood Risk

Based on:

• Rainfall
• Humidity
• Wind speed

Heatwave Risk

Based on:

• Temperature
• Humidity

---

🚨 Smart Alert System

The platform automatically generates alerts such as:

• ⚠ Flood Risk Detected
• ☀ Heatwave Risk Detected
• ✅ No major climate risks detected

---

🤖 ClimateBot AI Assistant

Climate Shield includes an integrated AI chatbot that provides:

• Flood awareness
• Heatwave precautions
• Cyclone safety guidance
• Climate change information
• Disaster preparedness suggestions

The chatbot is lightweight and rule-based.

---

🖥 Frontend

Built using:

• HTML5
• CSS3
• Vanilla JavaScript

Frontend features:

• Glassmorphism UI
• Responsive design
• Animated result cards
• Interactive chatbot widget
• Live climate analysis

---

⚙ Backend

Powered by:

• Python
• Flask
• Flask-CORS

Backend responsibilities:

• Weather API communication
• Risk calculations
• Climate alert generation
• Chatbot API responses
• Frontend serving

---

🧠 Tech Stack

Technology	Purpose
Python	Backend logic
Flask	API server
Flask-CORS	Cross-origin support
HTML/CSS/JS	Frontend
OpenWeatherMap API	Live weather data
Render	Deployment

---

📂 Project Structure

Climate-Shield/
├── AI-chatbot/
│   └── chatbot.py
│
├── backend/
│   └── alertsystem.py
│
├── Frontend/
│   ├── index.html
│   ├── chatbot.js
│   ├── script.js
│   ├── style.css
│   │
│   └── Analysis/
│       ├── analysis.html
│       ├── analysis.css
│       └── analysis.js
│
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── requirements.txt

---

🛠 Installation Guide

⭐ Star the Repository

Prerequisites

Make sure you have the following installed before setup:

• Python 3.10 or later
• pip
• Git
• A free OpenWeatherMap API key

1️⃣ Clone Repository

git clone https://github.com/thetechguardians/Climate-Shield.git
cd Climate-Shield

---

2️⃣ Create Virtual Environment

Windows

python -m venv venv
venv\Scripts\activate

Linux / macOS

python3 -m venv venv
source venv/bin/activate

---

3️⃣ Install Dependencies

Install all backend dependencies from requirements.txt:

python -m pip install --upgrade pip
pip install -r requirements.txt

This installs Flask, Flask-CORS, Requests, python-dotenv, and Gunicorn.

---

4️⃣ Configure Environment Variables

Create a .env file in the root directory:

OPENWEATHER_API_KEY=your_api_key_here

Get your free API key from the OpenWeatherMap API.

---

5️⃣ Run Backend

python backend/alertsystem.py

Backend runs on:

http://127.0.0.1:5000

The Flask backend also serves the frontend, so you can open http://127.0.0.1:5000 in your browser after the server starts.

---

6️⃣ Open Frontend

Recommended local URL:

http://127.0.0.1:5000

You can also open the static frontend directly:

Frontend/index.html

or serve it locally:

cd Frontend
python -m http.server 8000

---

🌐 API Endpoints

Weather Analysis

POST /weather

Request

{
  "city": "Guwahati",
  "state": "Assam",
  "country": "India"
}

Response

{
  "success": true,
  "weather": {
    "temperature": 29,
    "humidity": 83,
    "rainfall": 5,
    "wind_speed": 12
  },
  "risks": {
    "flood_risk": 0.62,
    "heat_risk": 0.41
  },
  "alerts": ["⚠ Flood Risk Detected"]
}

---

Chatbot API

POST /chatbot

Request

{
  "message": "What precautions should I take during floods?"
}

Response

{
  "success": true,
  "response": "You should avoid low-lying areas during floods."
}

---

🚀 Deployment on Render

Deploy this project as a Render Web Service.

Required Settings

Setting	Value
Runtime	Python 3
Build Command	pip install -r requirements.txt
Start Command	gunicorn backend.alertsystem:app

gunicorn is required for the Render start command and is already listed in requirements.txt. Make sure Render installs dependencies from requirements.txt during the build step.

Environment Variables

Add the following environment variable in the Render dashboard:

Variable	Description
OPENWEATHER_API_KEY	OpenWeatherMap API Key

---

🔐 Environment Variables

Variable	Description
OPENWEATHER_API_KEY	OpenWeatherMap API Key

---

📈 Future Improvements

• 🌧 Rain prediction forecasting
• 📍 Interactive GIS climate maps
• 📲 SMS / Email emergency alerts
• 🛰 Satellite weather integration
• 🧠 Machine learning risk prediction
• 🌎 Multi-language support

---

🤝 Contributing

Contributions are welcome.

Please read:

CONTRIBUTING.md

before submitting pull requests.

---

🛡 License

This project is licensed under the MIT License.

---

👨‍💻 Authors

Developed by Team Climate Shield.

• @Vikrant0207

---

📞 Support & Community

🆘 Need Help?

• 💬 Discussions: GitHub Discussions
• 🐛 Bug Reports: Open an Issue
• 📧 Discord: Join Discord Server

🌟 Stay Connected

• 📱 Instagram: @vikrant.__07
• 💼 LinkedIn: Vikrant Kumar Mehta
• 🐙 GitHub: @Vikrant0207

---

🌍 Vision

Climate Shield aims to make climate risk awareness:

• Fast
• Accessible
• Intelligent
• Easy to understand

for communities, students, researchers, and emergency responders.

---

⭐ Show Your Support

If this project helped you, please consider:

• ⭐ Starring this repository
• 🍴 Forking it to contribute
• 📢 Sharing it with others
• 💖 Following for more amazing projects
• 🛠 Contribute improvements

---