beacon emergency ai

README excerpt

# ⚡ BEACON — Autonomous Emergency AI

> Real-time disaster response coordination powered by Google Gemini 2.0 Flash, Elasticsearch, and MongoDB.

Built for the **Google Cloud Rapid Agent Hackathon 2026** — BEACON is an autonomous AI system that monitors shelters, road conditions, and supply caches during active disaster operations. It detects data conflicts, surfaces resource gaps, and answers natural-language coordination queries in real time.

---

## Screenshots

![BEACON Dashboard](docs/screenshot.png)

*Tactical dashboard showing the Kansas region operation with live incident feed and AI copilot.*

---

## Features

- **Live Incident Map** — Leaflet-powered geo map with shelter, road, and supply cache overlays
- **AI Coordination Copilot** — Chat interface backed by Gemini 2.0 Flash with tool-calling against live data
- **Alert Feed** — Polls the backend every 5 seconds for new conflict and resource gap alerts
- **Autonomous Conflict Detection** — Cloud Function scans Elasticsearch for contradictory road status reports
- **Resource Gap Monitor** — Flags shelters where meal supply ratios fall below critical thresholds
- **Situation Reporter** — Automated sitreps pushed to MongoDB every 2 hours
- **Keyword Fallback** — Full demo works without a Gemini API key using smart keyword routing

---

## Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                        Frontend (React + Vite)                  │
│  Dashboard · Map · Alert