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
Beautiful animated landing page with live risk status and quick navigation
Real-time monitoring with animated widgets, 7-day forecast, and live alerts
Advanced machine learning analysis with real-time hazard predictions
Interactive map with real shelter locations and route planning
| 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 |
| Earthquakes, floods, storms, wildfires |
| 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 |
| 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 |
Node.js 18+
Python 3.10+
npm or yarn# 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# 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
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
|
|
| 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 |
REACT_APP_API_URL=http://localhost:8000
REACT_APP_OPENWEATHER_API_KEY=your_api_key_herenpm run build
vercel deployPre-configured with render.yaml
docker build -t alert-aid .
docker run -p 3000:3000 alert-aidThe 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
| Device | Breakpoint |
|---|---|
| ๐ฑ Mobile | < 768px |
| ๐ฑ Tablet | 768px - 1024px |
| ๐ป Desktop | > 1024px |
- ๐ด Fork the repository
- ๐ฟ Create feature branch:
git checkout -b feature/amazing - ๐พ Commit changes:
git commit -m 'Add amazing feature' - ๐ค Push to branch:
git push origin feature/amazing - ๐ Open a Pull Request
MIT License - see LICENSE file.
|
Ayush @ayushap18 |



