Skip to content

README.md

Latest commit

 

History

History
253 lines (176 loc) · 8.7 KB

README.md

File metadata and controls

253 lines (176 loc) · 8.7 KB
Raw

🏆 Hackathon 🏫 College 👥 Team 📅 Date
CATCH '25 Mahendra Engineering College TECH MARVEL 20 / 02 / 2025

Python Generative AI Tkinter PHP

Stars Forks Last Commit Repo Size License

"Bridging the gap between patients and healthcare one conversation at a time."

〔 01 〕 What is MEDI AI?

MEDI AI is an AI-powered medical chatbot that acts as your personal virtual health assistant. Through natural conversation, it:

  • 🩺 Listens to your symptoms and understands what you're going through
  • 💊 Suggests possible medical conditions and prescriptions
  • 🏡 Recommends effective home remedies for minor conditions
  • 📅 Helps you book doctor appointments when things are serious
  • 🚨 Provides emergency guidance when needed

Built to make quality healthcare guidance accessible to everyone — no waiting rooms, no delays.

〔 02 〕 The Problem We Solve

❌  Patients misdiagnose themselves with random Google searches
❌  Fake practitioners and unqualified advice cause real harm
❌  Long hospital queues delay basic medical consultation
❌  Rural and low-income populations lack access to doctors

            ↓  MEDI AI solves this  ↓

✅  Instant symptom analysis via chat
✅  AI-backed suggestions grounded in medical logic
✅  Home remedy guidance for minor conditions
✅  Seamless appointment booking for serious cases

〔 03 〕 How It Works

  User
   │
   ▼
┌─────────────────────────────────────────────────────────────┐
│  STEP 1  │  User sends a message describing symptoms        │
├─────────────────────────────────────────────────────────────┤
│  STEP 2  │  AI processes the sentence using NLP algorithms  │
├─────────────────────────────────────────────────────────────┤
│  STEP 3  │  Symptoms are matched against medical database   │
├─────────────────────────────────────────────────────────────┤
│  STEP 4  │  Condition is classified as Minor or Major       │
├──────────────────────────┬──────────────────────────────────┤
│  MINOR CONDITION         │  MAJOR CONDITION                 │
│  → Disease name          │  → Disease name                  │
│  → Home remedies         │  → Prescription & analgesics     │
│  → Basic analgesics      │  → Diet plan                     │
│                          │  → Doctor booking                │
└──────────────────────────┴──────────────────────────────────┘

〔 04 〕 Core Features

🗣️ Symptom Checker Understands user input through natural language and maps symptoms to known medical conditions accurately.

💊 Prescription Engine Suggests appropriate over-the-counter medicines and analgesics based on identified conditions.

🏡 Home Remedy Guide For minor conditions, recommends safe, natural home remedies to avoid unnecessary clinic visits.

📅 Appointment Booking Connects patients with relevant specialists and schedules doctor appointments directly from the chat.

🚨 Emergency Assistance Detects critical symptoms and provides emergency contact information and first-aid guidance.

🔒 Privacy First All conversations are handled with patient privacy as the top priority — no data shared without consent.

〔 05 〕 Tech Stack

Language     : Python
GUI          : Tkinter
Backend      : PHP
AI Engine    : Generative AI (LLM-based)
Approach     : NLP + Rule-based Symptom Matching
Platform     : Desktop Application

--

〔 06 〕 Getting Started

1. Clone the repository

git clone https://github.com/SOMU3103/MED_AI.git
cd MED_AI

2. Install dependencies

pip install -r requirements.txt

3. Run the application

python main.py

〔 07 〕 Expected Outcomes

Outcome Impact
⏱️ Timely Monitoring Catch conditions early through regular symptom checks
💬 Real-time Interaction Instant responses — no waiting for a consultation
⏳ Reduced Waiting Time Skip the queue for minor conditions
😊 Patient Satisfaction Empathetic, clear, personalized responses
📈 Scalability Can handle thousands of users simultaneously

〔 08 〕 Social Relevance

MEDI AI isn't just a project — it's a response to a real crisis.

Real cases that inspired this project show the danger of unqualified medical advice. MEDI AI addresses this by:

  • 🏥 Healthcare System Efficiency — reducing unnecessary visits to overburdened hospitals
  • 💪 Patient Empowerment — giving people reliable information to make informed decisions
  • 🌍 Accessibility & Inclusivity — serving patients in remote and underserved areas
  • 🌐 Public Health Benefits — promoting preventive care and health awareness at scale

〔 09 〕 Team

Name Year Department Role
Somnath P II Year CSE 👑 Team Leader
Serveshwaran M II Year CSE Team Member
Nithish S II Year CSE Team Member
Mani Shirisha S II Year CSE Team Member
Sandhiya M II Year CSE Team Member

〔 10 〕 Contributing

# Fork → Clone → Branch → Commit → Push → Pull Request

git checkout -b feature/your-feature
git commit -m "feat: describe your change"
git push origin feature/your-feature

Future scope ideas:

  • 🌐 Multilingual support (Tamil, Hindi, etc.)
  • 📱 Mobile app (Android / iOS)
  • 🔬 Integration with real hospital APIs
  • 🧠 Improved NLP with fine-tuned medical LLM
  • 📊 Patient health history dashboard

〔 11 〕 License

MIT License — Copyright (c) 2025 Somnath P (SOMU3103)
Free to use, modify, and distribute with attribution.

LinkedIn GitHub MED AI


⭐ Star this repo if MEDI AI inspired you — it means the world to the team!