You can deploy this model and start earning money today!

jainikb/
stromsense

Name: stromsense
Availability: InStock

mit

Views

No views yet

🌊 StormSense — Flood & Heatwave Risk Intelligence

Real-time disaster risk detection for any city worldwide. Built with FastAPI + Leaflet.js.

Features

🌊 Flood Risk Detection — Rain intensity, forecast accumulation, humidity scoring
🌡️ Heatwave Detection — Temperature, heat index, consecutive hot day analysis
🗺️ Interactive Safe Zone Map — Nearest shelters, hospitals, evacuation points
🛡️ Precautions Engine — Context-aware safety recommendations
📱 PWA — Works offline with cached last results
⚡ Real-time — OpenWeatherMap API integration

Quick Start (Local)

bash

# 1. Clone
git clone https://github.com/YOUR_USERNAME/stormsense
cd stormsense

# 2. Install
pip install -r requirements.txt

# 3. Set API key
export OPENWEATHER_API_KEY=your_key_here
# Get free key from: https://openweathermap.org/api

# 4. Run
uvicorn app:app --reload --port 8000

# 5. Open browser
# http://localhost:8000

Deploy on Hugging Face Spaces

Step 1: Create a Hugging Face Account

Go to huggingface.co → Sign up (free)

Step 2: Create a New Space

Click your profile → New Space
Space name: stormsense (or any name)
License: MIT
SDK: Select Docker
Visibility: Public (or Private)
Click Create Space

Step 3: Upload Project Files

Option A — Git (Recommended)

bash

# Install git-lfs
git lfs install

# Clone your new Space
git clone https://huggingface.co/spaces/YOUR_USERNAME/stormsense
cd stormsense

# Copy all project files into this folder
cp -r /path/to/flood-heatwave-app/* .

# Push
git add .
git commit -m "Initial deploy"
git push

Option B — Web UI Upload

In your Space, click Files tab → Add file → Upload files

Upload all files maintaining folder structure:

app.py
requirements.txt
Dockerfile
README.md
templates/
  index.html
static/
  sw.js
  manifest.json

Step 4: Set API Key Secret

In your Space → Settings tab
Scroll to Repository secrets
Click New secret
Name: OPENWEATHER_API_KEY
Value: your OpenWeatherMap API key
Click Save

Step 5: Rebuild & Launch

After pushing files, Space rebuilds automatically
Wait ~2-3 minutes for Docker build
Your app is live at: https://huggingface.co/spaces/YOUR_USERNAME/stormsense

Step 6: Get Your Free API Key

Go to openweathermap.org/api
Click Sign Up → Free plan
Go to API Keys section
Copy your key
Either set as Space secret (for default) or users can enter it in the app

Project Structure

stormsense/
├── app.py              # FastAPI backend + risk algorithms
├── requirements.txt    # Python dependencies
├── Dockerfile          # Container for HF Spaces
├── README.md           # This file (also HF Space card)
├── templates/
│   └── index.html      # Full frontend (HTML/CSS/JS)
└── static/
    ├── sw.js           # Service Worker (offline/PWA)
    ├── manifest.json   # PWA manifest
    ├── icon-192.png    # App icon
    └── icon-512.png    # App icon

API Endpoints

Endpoint	Method	Description
`/`	GET	Main web interface
`/api/analyze?city=Mumbai&api_key=KEY`	GET	Full risk analysis
`/health`	GET	Service health check

Risk Score Algorithm

Flood Risk (0–100)

Current rainfall intensity (mm/hr): up to 40 pts
24h forecast accumulation: up to 25 pts
Humidity saturation: up to 15 pts
Thunderstorm activity: 20 pts
Wind speed: up to 10 pts

Heat Risk (0–100)

Temperature thresholds: up to 45 pts
Heat index (Steadman formula): up to 30 pts
Humidity amplification: up to 15 pts
Forecast consecutive hot periods: up to 15 pts

Tech Stack

Backend: Python 3.11, FastAPI, httpx
Frontend: Vanilla JS, Leaflet.js, OpenStreetMap
Weather Data: OpenWeatherMap API (free tier)
Deployment: Docker, Hugging Face Spaces
PWA: Service Worker, Web App Manifest

jainikb/stromsense