Guardian Angel 🚨 (2024 Cal-Hacks)

AI-Powered Emergency Reporter & Real-Time Speech Assistant

Guardian Angel is a life-saving emergency reporting application designed to assist 911 dispatchers during time-critical situations. When a user is unable to communicate, Guardian Angel automatically detects distress signals—such as falls or medical emergencies—and speaks on the user’s behalf using an AI-driven speech and language pipeline.

The system delivers accurate, structured, and context-aware emergency information in real time, improving response efficiency and outcomes when seconds matter.

---

What Guardian Angel Does

Guardian Angel acts as an intelligent intermediary between the user and emergency dispatch services.

It:

• Detects emergency situations automatically or via manual trigger
• Captures and processes live audio
• Uses an LLM to understand the situation
• Generates clear, dispatcher-ready speech
• Relays critical data such as:
  • Biometric readings
  • Medical history
  • Current physical state
  • Real-time location

---

System Overview

guardian-angel/ │ ├── mobile/ # React Native + Expo app │ ├── app/ │ ├── components/ │ └── ... │ ├── backend/ # FastAPI backend │ ├── main.py │ ├── requirements.txt │ └── ...

---

Tech Stack

Frontend

• React Native
• Expo
• TypeScript

Backend

• FastAPI (Python)
• REST-based architecture

AI & Audio

• Google Gemini for transcription and LLM reasoning
• Deepgram for audio processing and speech synthesis

---

---

How to Run Guardian Angel Locally

Prerequisites

You will need:

• Node.js (v18 or higher)
• Python (v3.10 or higher)
• Expo CLI
• Git

---

Step 1 — Clone the Repository

git clone https://github.com/your-org/guardian-angel.git
cd guardian-angel

cd mobile
npm install

Create a .env file in the mobile/ directory:

EXPO_PUBLIC_API_URL=http://localhost:8000


Start the Expo development server:

npx expo start


Run the app using:

iOS Simulator

Android Emulator

Physical device via Expo Go

Step 3 — Backend Setup (FastAPI)
cd backend
python -m venv venv
source venv/bin/activate        # macOS/Linux
venv\Scripts\activate          # Windows
pip install -r requirements.txt


Create a .env file in the backend/ directory:

GEMINI_API_KEY=your_gemini_api_key
DEEPGRAM_API_KEY=your_deepgram_api_key


Start the backend server:

uvicorn main:app --reload

The API will be available at:

http://localhost:8000