Skip to content

ayushap18/congenial-waddle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

48 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿšจ Alert-AID - AI-Powered Disaster Alert System

![Alert-AID](https://img.shields.io/badge/๐Ÿšจ_Alert--AID-Disaster_Prediction_System-red?style=for-the-badge)

Status React TypeScript Python License

A real-time disaster monitoring and emergency response application featuring ML-powered predictions, interactive evacuation maps, and live weather alerts.

๐Ÿš€ Quick Start โ€ข ๐Ÿ“ธ Screenshots โ€ข โœจ Features โ€ข ๐Ÿ› ๏ธ Tech Stack


๐Ÿ“ธ Screenshots

๐Ÿ  Home Page

Beautiful animated landing page with live risk status and quick navigation

Home Page

๐Ÿ“Š Dashboard

Real-time monitoring with animated widgets, 7-day forecast, and live alerts

Dashboard

๐Ÿค– AI/ML Predictions Page

Advanced machine learning analysis with real-time hazard predictions

Predictions

๐Ÿ—บ๏ธ Evacuation Routes

Interactive map with real shelter locations and route planning

Evacuation Routes


โœจ Features

๐ŸŒ Real-Time Monitoring

Feature Description
๐ŸŒก๏ธ Live Weather OpenWeatherMap & Open-Meteo APIs with 30-min caching
๐Ÿ“… 7-Day Forecast Accurate predictions with risk scoring
๐ŸŒฌ๏ธ Air Quality Real-time AQI monitoring and health alerts
โš ๏ธ Multi-Hazard Alerts Earthquakes, floods, storms, wildfires

๐Ÿ—บ๏ธ Interactive Maps

Feature Description
๐Ÿ›ค๏ธ Evacuation Routes OpenStreetMap with Leaflet integration
๐Ÿฅ Real Shelters Live data from Overpass API
๐Ÿ“ Auto Location Geolocation with fallback
๐Ÿ“ Route Planning Distance to 3 nearest shelters

๐Ÿค– AI/ML Analysis

Feature Description
๐Ÿ“Š Risk Scoring Multi-factor disaster risk assessment
๐Ÿง  Ensemble Models Multiple ML models for accuracy
๐Ÿ”ฎ Predictive Alerts Early warning system
๐Ÿ“ˆ Trend Analysis Historical pattern recognition

๐Ÿš€ Quick Start

Prerequisites

Node.js 18+
Python 3.10+
npm or yarn

Installation

# Clone the repository
git clone https://github.com/ayushap18/congenial-waddle.git
cd Alert-AID

# Install frontend dependencies
npm install

# Install backend dependencies
cd backend
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

Running the App

# Terminal 1: Start backend (port 8000)
cd backend && source venv/bin/activate
python -m uvicorn simple_backend:app --host 0.0.0.0 --port 8000

# Terminal 2: Start frontend (port 3000)
npm start

๐ŸŒ Open http://localhost:3000


๐Ÿ—๏ธ Project Structure

Alert-AID/
โ”œโ”€โ”€ ๐Ÿ“ src/                     # React Frontend
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ components/          # UI Components
โ”‚   โ”‚   โ”œโ”€โ”€ Dashboard/          # Main dashboard widgets
โ”‚   โ”‚   โ”œโ”€โ”€ Map/                # Leaflet evacuation maps
โ”‚   โ”‚   โ”œโ”€โ”€ Emergency/          # Emergency response
โ”‚   โ”‚   โ””โ”€โ”€ Safety/             # Safety modules
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ services/            # API services
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ hooks/               # Custom hooks
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ contexts/            # React contexts
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ pages/               # Page components
โ”‚   โ””โ”€โ”€ ๐Ÿ“ styles/              # Global styles
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ backend/                 # FastAPI Backend
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ routes/              # API endpoints
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ ml/                  # ML models
โ”‚   โ””โ”€โ”€ ๐Ÿ“ models/              # Trained models
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ public/                  # Static assets
โ”œโ”€โ”€ ๐Ÿ“ build/                   # Production build
โ””โ”€โ”€ ๐Ÿ“„ package.json

๐Ÿ› ๏ธ Tech Stack

Frontend

  • โš›๏ธ React 18 - UI Library
  • ๐Ÿ“˜ TypeScript - Type Safety
  • ๐Ÿ’… Styled Components - CSS-in-JS
  • ๐Ÿ—บ๏ธ Leaflet - Interactive Maps
  • ๐Ÿ“Š Recharts - Data Viz
  • ๐ŸŽจ Lucide Icons - Icons

Backend

  • ๐Ÿ FastAPI - Python API
  • โšก Uvicorn - ASGI Server
  • ๐Ÿค– Scikit-learn - ML
  • ๐Ÿผ Pandas - Data Processing
  • ๐Ÿ“ˆ NumPy - Numerical

๐Ÿ”Œ API Integrations

Service Purpose Rate Limit
๐ŸŒค๏ธ OpenWeatherMap Weather data 1000/day
๐ŸŒก๏ธ Open-Meteo Weather backup Unlimited
๐Ÿ—บ๏ธ OpenStreetMap Map tiles Unlimited
๐Ÿฅ Overpass API Shelter locations Unlimited
๐ŸŒ USGS Earthquake data Unlimited
๐Ÿ›ฐ๏ธ NASA EONET Natural events Unlimited

โš™๏ธ Environment Variables

REACT_APP_API_URL=http://localhost:8000
REACT_APP_OPENWEATHER_API_KEY=your_api_key_here

๐Ÿšข Deployment

Vercel (Frontend)

npm run build
vercel deploy

Render (Backend)

Pre-configured with render.yaml

Docker

docker build -t alert-aid .
docker run -p 3000:3000 alert-aid

๐ŸŽจ UI Animations

The app features cinematic animations throughout:

  • ๐ŸŒ€ Fade In Up - Page elements entrance
  • โœจ Pulse Glow - Active alerts & buttons
  • ๐ŸŽญ Scale In - Cards and popups
  • ๐Ÿ’ซ Float - Icons and indicators
  • ๐ŸŒˆ Shimmer - Loading states
  • ๐ŸŽช Bounce In - Notifications

๐Ÿ“ฑ Responsive Design

Device Breakpoint
๐Ÿ“ฑ Mobile < 768px
๐Ÿ“ฑ Tablet 768px - 1024px
๐Ÿ’ป Desktop > 1024px

๐Ÿค Contributing

  1. ๐Ÿด Fork the repository
  2. ๐ŸŒฟ Create feature branch: git checkout -b feature/amazing
  3. ๐Ÿ’พ Commit changes: git commit -m 'Add amazing feature'
  4. ๐Ÿ“ค Push to branch: git push origin feature/amazing
  5. ๐Ÿ”€ Open a Pull Request

๐Ÿ“„ License

MIT License - see LICENSE file.


๐Ÿ‘ค Author

Ayush
@ayushap18

๐Ÿ™ Acknowledgments

OpenStreetMap โ€ข OpenWeatherMap โ€ข NASA EONET โ€ข USGS


โญ Star this repo if you find it helpful!

๐Ÿšจ Stay Safe, Stay Prepared!

Releases

No releases published

Packages

No packages published