Skip to content

Healify is an AI-powered platform designed to simplify complex medical reports and provide accessible healthcare insights for patients

Notifications You must be signed in to change notification settings

Ihssane5/Healify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🩺 Healify: AI-Powered Healthcare Companion

Healify is an AI-powered platform designed to simplify complex medical reports and provide accessible healthcare insights for patients. By leveraging advanced AI technologies, Healify empowers users with clear, personalized health information through report analysis, a medical chatbot, and a skin disease detection tool.


✨ Features

Healify integrates four key AI-driven functionalities:

🧠 Healytics (AI-Powered Medical Report Analysis)

  • Goal: Simplifies medical reports into easy-to-understand summaries for non-experts.
  • Technology: Fine-tuned LLM (meta-llama/Llama-3.2-1B-Instruct) using LoRA for efficient training.
  • Data Strategy: Synthetic data generated from structured MIMIC-III (de-identified) records to address real medical data scarcity.
  • Process: Extracts text from uploaded PDFs and provides a simplified interpretation using the fine-tuned LLM.

💬 HealyChat (RAG-Powered Medical Q&A)

  • Goal: Provides accurate, up-to-date answers to medical questions based on patient records.
  • Technology: Retrieval Augmented Generation (RAG).
  • Benefits: Reduces hallucinations, retrieves relevant information from uploaded documents, and ensures domain-specific expertise.

📷 SkinGuard (AI-Driven Skin Disease Detection)

  • Goal: Automatically classifies skin lesions from images to assist in early diagnosis.
  • Technology: Custom Convolutional Neural Network (CNN).
  • Performance: 84% accuracy in classifying 5 common skin diseases:
    • Basal Cell Carcinoma
    • Dermatofibroma
    • Melanoma
    • Nevus
    • Vascular Lesions
  • Usage: Assists clinical diagnosis, triage, and education.

👩‍⚕️ Medical Assistant (DeepSeek Integration)

  • Goal: Interactive virtual medical assistant for general health inquiries.
  • Technology: DeepSeek LLM.
  • Functionality: Answers general medical questions and offers details about diseases detected by SkinGuard (e.g., causes, treatments).

📂 Dataset & Fine-Tuning Notebook

🔗 Hugging Face Dataset

The synthetic dataset used for training Healytics (medical report simplification) is available on my official Hugging Face Hub:

👉 Healify Synthetic Medical Notes
(Generated from structured MIMIC-III records all the processing informations and notebooks links can be found the dataset card)


📓 Fine-Tuning Notebook

The notebook used to fine-tune the Llama-3.2-1B-Instruct model via LoRA is available here:

👉 Healify Fine-Tuning Notebook on Kaggle
(Includes synthetic data loading, preprocessing, LoRA config, training loop, and evaluation)


For more technical details you can check the included report.

🧰 Tech Stack

  • Frontend: Html, Css, Js.
  • Backend: Django
  • AI/ML: Llama-3.2-1B-Instruct (fine-tuned), DeepSeek, Custom CNN
  • Data: Synthetic generation, MIMIC-III, Hugging Face datasets


📽 Demo & Preview

🖼️ UI Preview

Below is a snapshot of the Healify interface showcasing the Home Page and Services Dashboard:

Healify Home

Healify Services

Images include: AI report upload, chatbot, skin disease detection, and medical assistant features.


🎬 Live Demo Video

Watch our walkthrough video demonstrating Healify in action:
🔗 Watch the demo on LinkedIn


🎨 Canva Presentation (Project Overview & Design)

Explore our project via Canva:

📎 Open Canva Presentation


⚙️ Getting Started

Follow these steps to run Healify locally:

1. Clone the repository

git clone https://github.com/Ihssane5/Healify
cd healify

2. Create a virtual environment

conda env create -f env.yml

3. Activate the virtual environment

conda activate heal 

4. Run the application

python manage.py runserver 

5. Finally

Navigate to the provided link

🤝 Contributing Contributions are welcome! Please fork the repository and submit a pull request.

📄 License This project is licensed under the MIT License. See the LICENSE file for details.

✉️ Contact NEDJAOUI Ihssane 📧 ihssanenedjaoui5@gmail.com

About

Healify is an AI-powered platform designed to simplify complex medical reports and provide accessible healthcare insights for patients

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published