README.md

---
title: El7a2ny Backend
emoji: 🆘
colorFrom: red
colorTo: pink
sdk: docker
pinned: false
---

Ever wondered what you'd do if someone **collapsed** in front of you?<br>
El7a2ny is a mobile app that trains you to handle medical emergencies and guides you step-by-step as they happen.<br>
No medical degree needed — just follow the app, stay calm, and become the hero someone desperately needs.<br>

# 📝 Main Features

## 🫀 ECG Analysis
Export your Apple Watch ECG PDF analysis and import it directly into our mobile application. Our advanced diagnostic system performs comprehensive checkups to determine if your ECG readings are normal or show abnormalities. Based on the analysis results, you'll receive personalized guidance and recommendations for appropriate next steps.

## 🔥 Burn Assessment
Accidentally burned yourself on a stove or with boiling water? Simply take a photo and upload it to the app. Our intelligent image processing will:
- Automatically segment and identify the burn area
- Classify the burn degree (1st, 2nd, or 3rd degree)
- Provide immediate care guidelines and treatment recommendations

## 🚑 CPR Training & Analysis

### Educational Mode
Perfect your CPR technique at home or in training centers:
- Record yourself performing CPR (Cardiopulmonary Resuscitation)
- Upload the video for comprehensive analysis
- Receive detailed feedback on compression rate, depth, and technique
- Get posture corrections and improvement suggestions

### Real-Time Emergency Mode
For actual emergency situations:
- Mount your phone in portrait mode
- Start live CPR guidance with real-time feedback
- Get instant coaching during critical moments
- Ensure proper technique when every second counts

# 🚀 Installation
1. Clone the repository:
   ```bash
   git clone https://github.com/El7a2ny-Graduation-Project/Backend.git
   ```
2. Navigate to the project directory:
   ```bash
   cd Backend
   ```
3. Create a virtual environment (optional but recommended):
   ```bash
   python 3.10 -m venv venv	
   ```
4. Activate the virtual environment:
   - On Windows:
	 ```bash
	 venv\Scripts\activate
	 ```
   - On macOS/Linux:
	 ```bash
	 source venv/bin/activate
	 ```
5. Install the required packages:
   ```bash
   pip install -r requirements.txt
   ```

# Technical Setup

## Framework
This backend is built using the **FastAPI** Python framework and can be run both locally and accessed through our deployed instance on Hugging Face.

## Deployment Options

### 🌐 Production Deployment (Recommended)
For most application features, we recommend using our deployed instance on Hugging Face:

**Base URL:** `https://husseinhadidy-deploy-el7a2ny-application.hf.space`

**Supported Features:**
- Skin Burns Analysis
- ECG Analysis  
- CPR Education Mode

### 🏠 Local Deployment
For the **CPR Real-Time Mode**, local deployment is recommended due to latency requirements. The Hugging Face free container has limited specifications that may not provide optimal performance for real-time socket connections.

3. **Run the Application**
   ```bash
   uvicorn app:app --host 0.0.0.0 --port 8000
   ```

2. **Access the API**
   - Local URL: `http://localhost:8000`
   - API Documentation: `http://localhost:8000/docs`

# 🐞 Bugs, Suggestions or Questions
Please be welcome to submit an issue.

# 🎥 Run Demo
## CPR Module
1. Navigate to the project directory:
   ```bash
   cd Backend
   ```
2. Run the test demo for the CPR's educational mode:
   ```bash
   python -m Demo.demo -i "path_to_your_video.mp4" -o "path_to_output_directory"
   ```
   For example:
   ```bash
    python -m Demo.demo -i "Demo/Dataset/02.mp4" -o "Demo/Output"
   ```

# 👥 Collaborators
<table>
<tr>
    <td align="center">
        <a href="https://github.com/FatemaKotb">
            <img src="https://avatars.githubusercontent.com/u/101884853?v=4" width="100;" alt="Fatema-Kotb"/>
        </a>
    </td>
    <td align="center">
        <a href="https://github.com/Hussein-Hadidy">
            <img src="https://avatars.githubusercontent.com/u/111172851?v=4" width="100;" alt="Hussein-Hadidy"/>
        </a>
    </td>
    <td align="center">
        <a href="https://github.com/rana-abdalla1">
            <img src="https://avatars.githubusercontent.com/u/111182872?v=4" width="100;" alt="Rana-Abdalla"/>
        </a>
    </td>
    <td align="center">
        <a href="https://github.com/Sherif-Hatem1">
            <img src="https://avatars.githubusercontent.com/u/125387417?v=4" width="100;" alt="Sherif-Hatem"/>
        </a>
    </td>
</tr>
  <tr>
    <td align="center">
        <a href="https://github.com/FatemaKotb">
            Fatema Kotb
        </a>
    </td>
    <td align="center">
        <a href="https://github.com/Hussein-Hadidy">
            Hussein Hadidy
        </a>
    </td>
    <td align="center">
        <a href="https://github.com/rana-abdalla1">
            Rana Abdalla
        </a>
    </td>
    <td align="center">
        <a href="https://github.com/Sherif-Hatem1">
            Sherif Hatem
        </a>
    </td>
</tr>
    <tr>
    <td align="center">
        CPR Module Implementation
    </td>
    <td align="center">
        CPR Module Testing & Application Development
    </td>
    <td align="center">
        ECG Abalysis Module Implementation
    </td>
    <td align="center">
       Skin Burns Module Implementation & Application Development
    </td>
</tr>
</table>