Skip to content

Repository files navigation

💊 MedCare — Your Autonomous Health Companion

Doctor’s visit over. Now what?
MedCare transforms confusing prescriptions, complex medical scans, and dense reports into simple, actionable guidance. Designed for families and caregivers, it bridges the gap between the clinic and daily recovery with AI-driven adherence, smart reminders, and plain-language medical insights.


🎯 The Problem

In the rush of a clinical visit, patients often leave with:

  • Illegible Handouts: Messy handwritten prescriptions that are hard to decipher.
  • Complex Scans: MRI/CT/X-ray reports filled with intimidating medical jargon.
  • Adherence Gaps: Confusion over dosage timings, food precautions, and missed doses.
  • High Costs: Lack of visibility into cheaper, high-quality medicine alternatives.

MedCare solves the "post-visit black hole" by becoming your personal autonomous health companion.


✨ Key Features

📄 Smart Prescription OCR

  • Gemini 2.0 Flash Power: Upload any handwritten prescription. Our pipeline extracts medicine names, dosages, frequencies, and durations with high precision.
  • Price Transparency: Instant price comparison across 1mg, PharmEasy, Apollo, and Truemeds to find the most affordable options.

🧠 MedVision: Diagnostic Intelligence

  • Multi-Modal Analysis: Specialized Deep Learning models (DenseNet121, ResNet50) analyze X-rays, MRI, CT, and Ultrasound scans.
  • Plain-Language Reports: Converts complex findings into concise, 200-300 word summaries that anyone can understand.
  • Lab Report Insight: AI-driven analysis of blood tests and pathology reports.

⏰ Intelligent Adherence Agent

  • 30-Day Journey: One-click setup for your entire medication course.
  • Smart Reminders: Web Push notifications ensuring you never miss a dose.
  • Visual Progress: Dynamic Recharts dashboard showing ✅ Taken vs ❌ Missed adherence rates.

💬 Context-Aware AI Companion

  • LLaMA 3.3 70B Powered: An AI agent that remembers your medication history, allergies, and conditions.
  • Actionable Advice: Ask "How does this medicine affect my diet?" or "What are the side effects?" and get personalized, compassionate answers.

📍 Healthcare Connectivity

  • Doctor Finder: Integrated Leaflet.js + Overpass API to locate specialized doctors and hospitals near your live location.

📸 Visual Tour

Landing Page Dashboard

Prescription OCR MedVision


🛠️ Tech Stack

Layer Technology
Frontend React 19, Vite, Tailwind CSS 4, Framer Motion
Data Viz Recharts, Lucide Icons
Backend Python 3.10+, FastAPI, Uvicorn
AI Models Google Gemini 2.0 Flash, Groq (LLaMA 3.3 70B), Llama 4 Scout
Deep Learning PyTorch, Monai, TensorFlow, Keras
Database/Auth Supabase (PostgreSQL + Row Level Security)
Maps Leaflet.js, Overpass API
Notifications Service Workers, Web Push API

📊 Architecture Overview

graph TD
    A[User/Caregiver] -->|Upload Prescription/Scan| B(Vite Frontend)
    B -->|FastAPI Requests| C{MedCare API}
    C -->|OCR Request| D[Gemini 2.0 Flash]
    C -->|Imaging Analysis| E[Deep Learning Models]
    C -->|Chat Request| F[Groq LLaMA 3.3 70B]
    C -->|Sync Data| G[(Supabase DB)]
    G -->|Push Notification| H[Web Push Service]
    H -->|Reminder| A
Loading

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/Keshav-Swaraj/medCare.git
cd medCare

2. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# Add your GEMINI_API_KEY, GROQ_API_KEY
uvicorn main:app --reload --port 8000

3. Frontend Setup

# In a new terminal
cd ..
npm install
cp .env.example .env
# Add your VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY
npm run dev

⚠️ Important Disclaimer

Not a medical device. MedCare is a prototype developed for educational and demonstration purposes.

  • All AI outputs (OCR, Imaging, Chat) are preliminary and not a substitute for professional medical advice.
  • Always consult a certified healthcare professional before making any medical decisions.
  • Do not rely solely on this tool for emergency or critical health management.

🙌 Why We Built This

🙌 Why We Built MedCare

Doctor visits in India are often short and overwhelming. Patients — especially the elderly — leave with messy prescriptions they can't read, unclear instructions, and no real guidance for daily life.

This leads to confusion, missed doses, and poor adherence. Non-adherence rates among elderly patients with chronic illnesses in India frequently exceed 40–60%, resulting in complications, extra hospital visits, and heavy burden on families.

We built MedCare to fix this "post-visit gap".

It instantly converts confusing prescriptions and reports into simple, actionable guidance: clear schedules with food precautions, smart reminders, progress tracking, plain-language explanations, and an always-available AI companion — all designed for real Indian families.


👥 Team W Coders


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Patient Healthcare Management

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages