Skip to content

darrensh3n/FirstWaveAI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

FirstWaveAI - Emergency Dispatch Assistant


๐ŸŽฅ Demo

Demo Video

๐Ÿ† Devpost

View on Devpost


๐Ÿ’ก Inspiration

๐Ÿ“ž Over 240 million emergency calls are made in the United States each year (National Emergency Number Association), putting extreme pressure on dispatchers in life-or-death situations. In those critical first moments, key details can be missed, delayed, or misunderstood when callers are panicking.

FirstWaveAI was built to rethink the emergency intake process. I created an AI-powered call assistant that speaks directly with callers, asks clarifying questions, and structures critical information in real time. The system then visualizes the situation on a live map, identifies nearby resources, and generates an AI-assisted dispatch recommendation, all while keeping a human dispatcher in full control with an approval override. ๐Ÿš‘


๐Ÿšจ What it does

FirstWaveAI is a real-time emergency dispatch assistant that combines speech recognition, multi-agent AI, and interactive visualization to help dispatchers work faster and more accurately.


๐Ÿš€ Key Features

๐ŸŽ™๏ธ Voice-First Interface

  • Callers can speak naturally using the Web Speech API, while the system transcribes the conversation in real time and maintains a full transcript.

๐Ÿง  Multi-Agent AI Pipeline (LangGraph + LLaMA 3.3 70B)

Six specialized AI agents work together to analyze the call:

  • ๐Ÿ“ Extraction Agent โ€“ Captures key details (location, injuries, hazards, people count)
  • ๐Ÿšฆ Triage Agent โ€“ Assigns priority levels (P1โ€“P4)
  • โ“ Next-Question Agent โ€“ Suggests clarifying follow-ups
  • ๐Ÿš“ Dispatch Planner โ€“ Recommends EMS, Fire, or Police
  • ๐Ÿ—บ๏ธ Resource Locator โ€“ Finds nearest available units with ETAs
  • ๐Ÿ›ก๏ธ Safety Guardrail โ€“ Ensures ethical recommendations

๐Ÿ–ฅ๏ธ Interactive Dashboard

A clean three-column interface shows:

  • Live chat transcript ๐Ÿ’ฌ
  • AI-generated emergency summary ๐Ÿ“
  • Dispatch recommendations with approve/cancel controls โœ…โŒ

๐Ÿ—บ๏ธ Resource Mapping

An interactive Leaflet map displays nearby hospitals, fire stations, police, and pharmacies with distances and travel times.


๐Ÿ› ๏ธ Tech Stack

Backend (AI & Data Processing)

  • Python 3.13+ - Core programming language
  • FastAPI - Modern, high-performance web framework
  • LangGraph - Multi-agent AI workflow orchestration
  • Groq + LLaMA 3.3 70B - High-performance LLM inference
  • Fish Audio API - Text-to-speech synthesis
  • Server-Sent Events (SSE) - Real-time streaming updates
  • Uvicorn - ASGI server for production deployment

Frontend (Visualization & UI)

  • Next.js 16 - React framework with App Router
  • React 19 - Latest React features
  • TypeScript - Type-safe development
  • Tailwind CSS 4 - Utility-first styling with custom emergency theme
  • shadcn/ui - High-quality component library
  • Leaflet + OpenStreetMap - Interactive mapping
  • Web Speech API - Real-time speech recognition and transcription

๐ŸŽฎ Quick Start

Prerequisites

  • Python 3.13+
  • Node.js 18+
  • npm/yarn
  • Groq API Key (for LLaMA 3.3 70B - get free at console.groq.com)
  • Fish Audio API Key (for text-to-speech - optional)

1. Clone the Repository

git clone https://github.com/your-username/firstwave.git
cd firstwave

2. Backend Setup

cd backend

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env and add your API keys:
# - GROQ_API_KEY=your-groq-api-key-here
# - FISH_AUDIO_API_KEY=your-fish-audio-api-key-here (optional)
# - FISH_AUDIO_VOICE_ID=optional_voice_id (optional)

# Start the backend server
python main.py

Backend will be running at http://localhost:8000

3. Frontend Setup

cd frontend

# Install dependencies
npm install

# Start the development server
npm run dev

Frontend will be running at http://localhost:3000


๐Ÿ”ฌ Use Cases

This platform serves multiple emergency response applications:

  • Emergency Call Triage: Real-time analysis and prioritization of emergency calls
  • Dispatcher Assistance: AI-powered support for human dispatchers
  • Resource Optimization: Intelligent matching of emergencies with nearby resources
  • Response Time Improvement: Faster information extraction and dispatch recommendations

๐Ÿ“„ License

This project is licensed under the MIT License.

About

๐Ÿ† United Hacks V6 Winner โ€” Multi-agent app for emergency dispatch assistance with speech recognition and interactive visualization

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors