A real-time AI-powered emergency alert system that connects patients to the nearest hospital — automatically, intelligently, instantly.
🚀 Features • 🧠 How It Works • ⚙️ Tech Stack • 🛠️ Setup • 📸 Screenshots • 🗺️ Roadmap
LifeLine is an AI-powered emergency SOS web application built to bridge the critical gap between someone in distress and the nearest available hospital — in under 10 seconds.
When a user triggers an SOS:
- A 5-second countdown gives them a chance to cancel accidental triggers
- Their GPS location is captured automatically
- Their pre-registered medical conditions are sent to the API
- The AI finds the shortest-distance hospital using routing analysis
- The hospital receives an instant real-time alert with patient details and location
💡 Built as a Hackathon project. Designed for real-world deployment in India's emergency response ecosystem.
| Feature | Description |
|---|---|
| 🆘 One-Tap SOS | Single button triggers the entire emergency flow |
| ⏱️ 5-Second Safety Countdown | Prevents accidental alerts with a cancellable timer |
| 📍 Auto GPS Location Capture | Browser geolocation API captures exact coordinates |
| 🧠 AI Hospital Routing | Finds shortest-distance hospital using pre-registered medical data |
| 🏥 Hospital Dashboard | Real-time alert receiver for hospital staff |
| 🗺️ Live Alert Map | Real-time map showing active SOS locations |
| 📋 Medical Profile Integration | Pre-registered conditions sent with every alert |
| 🔐 Encrypted Data | Patient data encrypted using cryptography library |
| ⚡ Real-time Updates | Instant sender ↔ receiver communication |
USER PRESSES SOS BUTTON
│
▼
┌─────────────────────┐
│ 5-Second Countdown │ ← User can cancel if accidental
│ ⏱️ 5 4 3 2 1... │
└────────┬────────────┘
│ (not cancelled)
▼
┌─────────────────────┐
│ GPS Location │ ← Browser Geolocation API
│ 📍 lat, lng capture │
└────────┬────────────┘
│
▼
┌─────────────────────────────────────┐
│ AI Analysis (FastAPI Backend) │
│ • Patient's pre-registered │
│ medical conditions │
│ • Location coordinates │
│ • Distance to all registered │
│ hospitals │
│ → Returns: Nearest suitable hospital│
└────────┬────────────────────────────┘
│
▼
┌─────────────────────┐ ┌──────────────────────┐
│ Patient sees: │ │ Hospital receives: │
│ ✅ Alert sent │ │ 🔔 SOS Notification │
│ 🏥 Hospital name │ │ 📍 Patient location │
│ 📏 Distance/ETA │ │ 🩺 Medical conditions│
│ 🗺️ Live map │ │ ⏰ Time of alert │
└─────────────────────┘ └──────────────────────┘
| Technology | Purpose |
|---|---|
| Python 3.10+ | Core language |
| FastAPI | High-performance REST API framework |
| SQLAlchemy | ORM for database operations |
| SQLite | Lightweight database (upgradeable to PostgreSQL) |
| Uvicorn | ASGI server |
| cryptography | Patient data encryption |
| python-dotenv | Environment variable management |
| requests | External API calls for routing |
| Technology | Purpose |
|---|---|
| HTML5 / CSS3 | Structure and styling |
| JavaScript | SOS countdown, geolocation, real-time updates |
| Geolocation API | Browser GPS capture |
| Leaflet.js / Maps API | Live alert map visualization |
- Python 3.10+
- pip
- Git
git clone https://github.com/<your-username>/lifeline.git
cd lifelinepython -m venv .venv
# Windows PowerShell
.venv\Scripts\Activate.ps1
# Windows CMD
.venv\Scripts\activate.bat
# Mac / Linux
source .venv/bin/activatepip install fastapi uvicorn sqlalchemy requests python-dotenv cryptographycp .env.example .env
# Edit .env with your configurationpython -c "from newalert.backend.database import init_db; init_db()"# Development (localhost — allows browser geolocation)
python -m uvicorn newalert.backend.main:app --reload --host 127.0.0.1 --port 8000http://127.0.0.1:8000
⚠️ Note: Browsers require HTTPS for geolocation on non-localhost origins. Uselocalhostfor development or deploy with HTTPS for production.
lifeline/
├── newalert/
│ └── backend/
│ ├── main.py ← FastAPI app entry point
│ ├── database.py ← SQLAlchemy models & DB init
│ ├── routes/
│ │ ├── alert.py ← SOS alert endpoints
│ │ └── hospital.py ← Hospital dashboard endpoints
│ └── utils/
│ ├── geo.py ← Distance calculation & routing
│ └── encrypt.py ← Data encryption utilities
├── frontend/
│ ├── index.html ← User SOS page
│ ├── hospital.html ← Hospital dashboard
│ └── static/
│ ├── style.css
│ └── app.js ← Countdown, geolocation logic
├── .env.example
├── .gitignore
├── requirements.txt
└── README.md
- ✅ Patient medical data is encrypted before storage
- ✅
.env,certs/, andlifeline.dbare gitignored — never committed - ✅ Location data is only used during active alert — not stored permanently
- ✅ Hospital access is authenticated — no public access to patient data
- SOS button with 5-second countdown
- GPS location capture
- AI-powered nearest hospital routing
- Hospital real-time alert dashboard
- Live alert map
- Medical profile integration
- 🔜 SMS/WhatsApp notification to family contacts
- 🔜 Deploy on AWS EC2 with HTTPS
- 🔜 Mobile PWA (installable on phone)
- 🔜 Multi-language support (Tamil, Hindi)
- 🔜 Ambulance tracking integration
- 🔜 Voice-activated SOS trigger
Inter-College Hackathon 2025 — Problem Statement: AI Solutions for Rural Healthcare
🥇 Selected to represent college | Successfully built & demonstrated working prototype
Pull requests are welcome! For major changes, please open an issue first.
git checkout -b feature/your-feature-name
git commit -m "Add: your feature description"
git push origin feature/your-feature-nameRajanithi N
- 🎓 AI & Data Science Student — Dhanalakshmi Srinivasan University
- 📧 rajanithiff@gmail.com
- 🏅 IBM | Google | Microsoft | AWS Certified (Coursera)
This project is licensed under the MIT License.
⭐ If LifeLine helped or inspired you, give it a star!
Built with ❤️ to save lives