Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🩺 AI Medical Report Assistant

An AI-powered web application that analyzes medical reports, explains complex laboratory results in simple language, compares reports over time, and generates personalized health insights.

Built using Python, Streamlit, Google Gemini 2.5 Flash, OCR, and Pydantic.


✨ Features

  • 📄 Upload PDF and image-based medical reports
  • 🔍 OCR support for scanned reports using EasyOCR
  • 🤖 AI-generated medical report summaries
  • 📊 Health Dashboard with overall health score
  • ⚠️ Detection and explanation of abnormal findings
  • ✅ Categorized normal findings
  • 💡 Personalized health recommendations
  • 📈 Compare two medical reports and track health progress
  • 💬 AI chatbot to answer questions about the uploaded report
  • 📥 Export AI-generated summary as a PDF

🛠️ Tech Stack

Technology Purpose
Python Backend logic
Streamlit Web application
Google Gemini 2.5 Flash AI report analysis
EasyOCR Text extraction from images
PyMuPDF PDF text extraction
Pydantic Structured data validation
ReportLab PDF report generation

📂 Project Structure

AI_Medical_Report_Assistant/
│
├── assets/                 # CSS styling
├── components/             # Streamlit UI components
├── utils/                  # OCR, AI, comparison and helper functions
├── sample_reports/         # Sample reports for testing
├── screenshots/            # Project screenshots
├── app.py                  # Main application
├── requirements.txt
├── README.md
└── .gitignore

🚀 Installation

Clone the repository

git clone https://github.com/<ankithamohan05-star>/AI_Medical_Report_Assistant.git

Navigate into the project

cd AI_Medical_Report_Assistant

Create a virtual environment

python -m venv venv

Activate the virtual environment

Windows

venv\Scripts\activate

Install dependencies

pip install -r requirements.txt

Create a .env file and add your Gemini API key

GEMINI_API_KEY=YOUR_API_KEY

Run the application

streamlit run app.py

📸 Screenshots

Screenshots of the application are available in the screenshots folder.

Example pages include:

  • Health Dashboard
  • Executive Summary
  • Abnormal Findings
  • Previous Report Comparison
  • AI Chat
  • PDF Export

🔮 Future Improvements

  • Support reports from more laboratory formats
  • Interactive trend charts for health markers
  • Multi-language support
  • User authentication
  • Cloud database for report history

👩‍💻 Developer

Ankitha Mohan

Medical Electronics Engineering Student


⚠️ Disclaimer

This application provides AI-generated explanations for educational and informational purposes only. It is not intended to replace professional medical advice, diagnosis, or treatment.

About

An AI-powered medical report analysis application that uses Google Gemini AI to summarize reports, explain lab results, compare previous reports, and answer medical questions through an interactive chatbot.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages