Skip to content

sunehachoudhary/Medical-Recommendation-System

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

59 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฉบ๐Ÿ’Š Medical Recommendation System

Welcome to the Medical Recommendation System, a simple yet powerful web-based medicine recommendation platform designed to assist doctors and support patients by providing relevant medicine suggestions based on symptoms or input data. This project combines Flask backend with modern web technologies to deliver a responsive and interactive healthcare experience.


๐Ÿ’ก Why This Project?

In today's fast-paced world, quick and reliable medical guidance is essential. This project aims to:

  • Help doctors make quicker preliminary decisions
  • Provide patients with basic awareness about common symptoms
  • Recommend suitable medicine names based on input
  • Serve as a starting point for integrating AI-based diagnostics in the future
  • Support telemedicine and rural diagnosis
  • Educational tool for aspiring medical technologists

๐Ÿš€ Features

Feature Description
๐Ÿฉบ Symptom-Based Recommendations Input symptoms and receive relevant medicine suggestions
๐Ÿ‘จโ€โš•๏ธ Doctor Support Tool Assists healthcare professionals with preliminary decisions
๐Ÿ‘ฅ Patient Awareness Provides patients with basic awareness about common symptoms
๐Ÿ“ฑ Responsive Design Bootstrap-powered interface that works across all devices
๐Ÿ“Š Interactive Interface Clean, user-friendly web interface built with modern technologies
โšก Flask Backend Python Flask framework for reliable server-side processing
๐ŸŽฏ Beginner-Friendly Simple implementation perfect for learning and development
๐Ÿฅ Healthcare Applications Useful for telemedicine and rural diagnosis support

๐Ÿ“ธ Project Preview

Home Page Interface Screenshot Results Display


๐Ÿง  Tech Stack

  • Frontend: HTML, CSS, JavaScript, Bootstrap
  • Backend: Python (Flask Framework)
  • Development Environment: PyCharm (Recommended)
  • Web Technologies: Responsive design with Bootstrap CSS framework

๐Ÿ“ Project Structure

Medical-Recommendation-System/
โ”œโ”€โ”€.idea/
โ”œโ”€โ”€Dataset/
โ”œโ”€โ”€ Static/                  # CSS, JavaScript, and static assets
โ”œโ”€โ”€ Templates/               # HTML templates for Flask web interface
โ”œโ”€โ”€ Models/
โ”œโ”€โ”€ Main.py                  # Flask application entry point
โ”œโ”€โ”€ README.md                # Project documentation
โ””โ”€โ”€ [Other files]            # Additional project components

โš™๏ธ Setup Instructions

๐Ÿ“‹ Prerequisites

  • Python 3.7+
  • PyCharm IDE (Highly Recommended)
  • Virtual environment (recommended for best practices)

๐Ÿ›  Steps

โš ๏ธ Important: This project is best run using PyCharm IDE.

  1. ๐Ÿ“ฅ Clone the Repository
git clone https://github.com/Lucky920487/Medical-Recommendation-System.git
cd Medical-Recommendation-System
  1. ๐Ÿ”ง Open in PyCharm

    • Launch PyCharm IDE

    • Open the project folder in PyCharm

    • Set up a virtual environment within PyCharm

  2. ๐Ÿ“ฆ Install Dependencies

pip install flask
# Install any additional dependencies as required
  1. ๐Ÿš€ Run the Application
python Main.py
  1. ๐ŸŒ Access the System Open your browser and navigate to the local development server (typically http://localhost:5000)

๐Ÿ’ป How Users Interact

  1. Access the Web Interface โ€“ Users open the web application in their browser.
  2. Input Symptoms โ€“ Enter symptoms or medical conditions into the system.
  3. Get Recommendations โ€“ Receive relevant medicine suggestions based on the input.
  4. Review Results โ€“ View the recommended medicines with relevant information.
  5. Educational Use โ€“ Learn about common symptoms and their treatments.

โš ๏ธ Important Medical Disclaimer

Critical Notice: This is a beginner-level project and does NOT replace professional medical advice.
Always consult certified doctors for critical care and medical decisions.

This tool should be used for:

  • Educational purposes
  • Preliminary guidance only
  • Learning about medical technology
  • Supporting telemedicine initiatives

๐ŸŽฏ Use Cases

  • Telemedicine: Remote healthcare delivery with basic diagnostic support
  • Rural Diagnosis Support: Assisting healthcare workers in areas with limited resources
  • Learning Tool: Educational resource for aspiring medical technologists
  • Quick Reference: Preliminary guidance for common symptoms
  • Healthcare Technology Education: Understanding medical recommendation systems

๐Ÿ›  Development Setup

For PyCharm Users (Recommended)

  1. Open PyCharm and select "Open Project".
  2. Navigate to the cloned repository folder.
  3. Configure Python interpreter and virtual environment.
  4. Install Flask and other dependencies via PyCharm terminal.
  5. Run Main.py directly from the IDE.

Alternative Setup

# Create virtual environment
python -m venv medical_env
source medical_env/bin/activate  # On Windows: medical_env\Scripts\activate

# Install dependencies
pip install flask

# Run the application
python Main.py

๐Ÿ›  Troubleshooting

  • Flask Not Starting: Ensure Python 3.7+ and Flask are properly installed.
  • PyCharm Issues: Verify virtual environment is correctly configured.
  • Port Conflicts: Check if port 5000 is available or modify in Main.py.
  • Template Errors: Ensure templates/ directory exists with HTML files.
  • Static Files Not Loading: Verify static/ directory contains CSS and JS files.

๐Ÿค Contributing

We welcome contributions from the community! This project is perfect for:

  • Healthcare technology enthusiasts
  • Medical students and professionals
  • Python/Flask developers
  • Anyone interested in healthcare applications

How to Contribute:

  1. Fork the Repository
  2. Create a Feature Branch:
    git checkout -b feature/your-feature-name
    
  3. Make Your Changes
  4. Commit and Push:
    git commit -m "Add: your descriptive message"
    Submit a Pull Request
  5. Submit a Pull Request

For feature suggestions or improvements, open an issue on GitHub.

Let's build something meaningful together! ๐Ÿ’ก


๐Ÿ”ฎ Future Enhancement Possibilities

  • Integration of machine learning models for better accuracy
  • Database integration for storing user data and recommendations
  • Advanced symptom analysis algorithms
  • Mobile application development
  • Multi-language support
  • Real-time consultation features
  • API development for third-party integrations

๐Ÿ‘ฉโ€๐Ÿ’ป Developer

Lucky Kumari
Aspiring Data Scientist with passion for Healthcare Technology โค๏ธ

๐Ÿ”— GitHub: @Lucky920487


๐Ÿ“„ License

This project is open-source and available for educational and development purposes.
Feel free to use, modify, and distribute with proper attribution.


๐ŸŒŸ Acknowledgments

  • Thanks to the open-source community for inspiration and support
  • Special appreciation for healthcare professionals who guide medical accuracy
  • Built for the healthcare technology learning community
  • Powered by Flask, Bootstrap, and modern web technologies

๐Ÿ“ž Support & Community

  • ๐Ÿ› Found a Bug? Open an issue
  • ๐Ÿ’ก Have Ideas? We'd love to hear your suggestions!
  • ๐Ÿค” Need Help? Check the documentation or reach out
  • ๐ŸŒŸ Enjoyed the Project? Give it a star on GitHub!

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Jupyter Notebook 49.5%
  • HTML 35.4%
  • Python 11.6%
  • CSS 1.9%
  • JavaScript 1.6%