README.md

metadata

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?
El7a2ny is a mobile app that trains you to handle medical emergencies and guides you step-by-step as they happen.
No medical degree needed — just follow the app, stay calm, and become the hero someone desperately needs.

📝 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:

   git clone https://github.com/El7a2ny-Graduation-Project/Backend.git
   

2. Navigate to the project directory:

   cd Backend
   

3. Create a virtual environment (optional but recommended):

   python 3.10 -m venv venv	
   

4. Activate the virtual environment:
   • On Windows:

     venv\Scripts\activate
     

   • On macOS/Linux:

     source venv/bin/activate
     

5. Install the required packages:

   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

   uvicorn app:app --host 0.0.0.0 --port 8000
   

4. 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:

   cd Backend
   

2. Run the test demo for the CPR's educational mode:

   python -m Demo.demo -i "path_to_your_video.mp4" -o "path_to_output_directory"
   

   For example:

    python -m Demo.demo -i "Demo/Dataset/02.mp4" -o "Demo/Output"
   

👥 Collaborators

Fatema Kotb	Hussein Hadidy	Rana Abdalla	Sherif Hatem
CPR Module Implementation	CPR Module Testing & Application Development	ECG Abalysis Module Implementation	Skin Burns Module Implementation & Application Development