🚨 EmergencyConnect-AI

AI-Powered Emergency Assistance Backend built with Django REST Framework, Gemini AI & Supabase

---

📌 Overview

EmergencyConnect-AI is an intelligent emergency assistance backend that leverages Generative AI to provide quick emergency classification and first-aid guidance.

Given a user's emergency description, the system:

• 🚑 Classifies the emergency type
• ⚠️ Determines the priority level
• 📝 Generates a concise emergency summary
• 🩺 Provides immediate first-aid recommendations
• ☁️ Stores AI responses for future analysis

---

✨ Features

Feature	Description
🤖 AI Emergency Analysis	Understands natural language emergencies
🚑 Emergency Classification	Identifies emergency category
⚠️ Priority Detection	LOW / MEDIUM / HIGH / CRITICAL
🩺 First Aid Assistance	Immediate safety recommendations
📚 Swagger Documentation	Interactive API testing
📖 MkDocs Documentation	Complete project documentation
☁️ Supabase Integration	Cloud database logging
🔄 Retry & Fallback Logic	Handles AI/API failures gracefully

---

🛠 Tech Stack

Category	Technologies
Backend	Python, Django, Django REST Framework
AI	Gemini AI
Database	Supabase, PostgreSQL, SQLite
Documentation	Swagger (drf-spectacular), MkDocs

---

🏗 Architecture

             User
                │
                ▼
       Django REST API
                │
                ▼
         Gemini AI Service
                │
                ▼
      Emergency Classification
                │
                ▼
        Structured JSON Output
                │
                ▼
         Supabase Logging

---

📂 Project Structure

backend/
│
├── ai_assistant/
├── emergency/
├── users/
├── emergencyconnect/
├── docs/
│   ├── index.md
│   ├── installation.md
│   ├── api.md
│   ├── ai_module.md
│   └── deployment.md
│
├── manage.py
├── requirements.txt
├── mkdocs.yml
└── README.md

---

🚀 Installation

Follow these steps to set up EmergencyConnect-AI on your local machine.

1️⃣ Clone the Repository

git clone https://github.com/akeren12/EmergencyConnect-AI.git
cd EmergencyConnect-AI/backend

---

2️⃣ Create a Virtual Environment

python -m venv venv

---

3️⃣ Activate the Virtual Environment

🪟 Windows

venv\Scripts\activate

🐧 Linux / 🍎 macOS

source venv/bin/activate

---

4️⃣ Install Dependencies

pip install -r requirements.txt

---

5️⃣ Apply Database Migrations

python manage.py migrate

---

6️⃣ Start the Development Server

python manage.py runserver

---

🎉 Open in Your Browser

http://127.0.0.1:8000/

---

✅ You're Ready!

Your local instance of EmergencyConnect-AI is now running and ready for development and testing.

---

📸 Project Screenshots

Swagger UI	MkDocs Documentation
docs/images/mkdocs-home.png

📡 API Endpoints

Method	Endpoint	Description
POST	/api/ai/analyze/	Analyze emergency description
GET	/api/schema/	OpenAPI Schema
GET	/api/schema/swagger-ui/	Swagger Documentation

---

📚 API Documentation

Swagger UI

http://127.0.0.1:8000/api/schema/swagger-ui/

Interactive OpenAPI documentation generated using drf-spectacular.

Postman Collection

Available in:

docs/postman/EmergencyConnect-AI.postman_collection.json

🤖 Sample Request

{ "description": "A person is unconscious and not breathing." }

---

✅ Sample Response

{ "emergency_type": "Cardiac Arrest", "priority": "CRITICAL", "summary": "The person appears to be in cardiac arrest.", "first_aid": [ "Call emergency services immediately.", "Begin CPR if trained.", "Use an AED if available." ] }

🧪 Test Coverage

EmergencyConnect-AI includes a comprehensive automated testing suite built with pytest.

Test Summary

• ✅ 27 Passing Tests
• ✅ Serializer Tests
• ✅ View Tests
• ✅ Authentication Flow Tests
• ✅ AI Integration Tests (Gemini API Mocked)
• ✅ 95% Overall Test Coverage

Coverage Report

---

📚 Documentation

Documentation	Link
Swagger UI	/api/schema/swagger-ui/
OpenAPI Schema	/api/schema/
MkDocs	mkdocs serve

---

🚀 Current Status

Module	Status
Django Backend	✅ Completed
REST APIs	✅ Completed
Gemini AI Integration	✅ Completed
Swagger Documentation	✅ Completed
MkDocs Documentation	✅ Completed
Supabase Integration	✅ Completed
Retry & Fallback Logic	✅ Completed
Deployment	🔄 In Progress

---

🔮 Future Enhancements

• 📱 One-Tap SOS
• 🎤 Voice Emergency Detection
• 🏥 Nearby Hospital Locator
• 🩸 Blood Bank Recommendations
• 💊 Pharmacy Recommendations
• 🌍 Multilingual Support
• 📍 Live Location Sharing
• 🚨 AI-generated SOS Messages

---

🌐 Live Demo

Live URL: https://emergencyconnect-ai-production-ae23.up.railway.app/login

## 👩‍💻 Author

**Aksa Elsa Jose**

B.Tech Computer Science & Engineering (Data Science)

**AI • Django • REST APIs • Generative AI**

---

<div align="center">

⭐ If you found this project useful, consider giving it a star!

Built with ❤️ using Django REST Framework & Gemini AI

</div>