NEXUS is a high-fidelity, professional emergency command platform designed for real-world crisis orchestration. It leverages Gemini-2.0-Flash AI to perceive natural language distress signals and autonomously coordinate secondary and tertiary responder dispatches with a strict Life-Safety First priority.
- 🧬 PERCEPTION LAYER: High-intensity AI classification with a 4-second "Quota Shield" and a SENTRY Local Heuristic fallback.
- 🚑 ORCHESTRATION HUB: Tactical SOP Engine that automatically prioritizes Ambulance and Hospital units as the primary responders for all Civil and Traffic emergencies.
- 📡 BROADCAST GRID: 200% Mission-Redundancy via Twilio SMS and Telegram Bot API, transmitting live GPS fixes and Google Maps links instantly.
- 🔐 IDENTITY HANDSHAKE: Production-hardened security with JWT Token Verification and SlowAPI Rate Limiting to prevent tactical interference.
- 🏛️ MISSION LOGS: Persistent cloud archival of all past incidents via Firebase Realtime Database.
# 1. INSTALL MISSION LIBRARIES
pip install -r requirements.txt
# 2. SEIZE CONTROL (Launch Engine)
python -m uvicorn main:app --host 0.0.0.0 --port 8888 --reload
# 3. LAUNCH DASHBOARD
npm run dev- Backend: ☁️ Optimized for Google Cloud Run (Dockerized) or Render.
- Frontend: 🌐 Optimized for Vercel or Firebase Hosting.
- Backend: FastAPI (Python 3.11+)
- Frontend: Vite, React, TailwindCSS, Framer Motion
- AI Intelligence: Google Gemini-2.0-Flash
- Cloud Infrastructure: Firebase (RTDB + Auth), Twilio, Telegram API
The NEXUS Hub is now officially unsealed and active. 🛡️✨🆘📡🚀🆘