Home

MediAssist Diagnostic System

Table of Contents

1. Overview
2. Features
3. Getting Started
   • Prerequisites
   • Installation
   • Usage
   • Options
4. Code Structure
5. Contributing
6. License
7. Acknowledgments
8. Support
9. Disclaimer

Overview

MediAssist is a diagnostic system implemented in Python that utilizes machine learning models to assess symptoms, predict potential diseases, and provide recommendations. The system employs a Decision Tree classifier and a Support Vector Classifier (SVC) to analyze user-reported symptoms and generate predictions.

Features

• Symptom Assessment: Users input their symptoms, and the system evaluates the severity, predicts potential diseases, and suggests precautions.
• Email Results: Optionally, users can receive the assessment results via email.

Getting Started

Prerequisites

• Python 3.x
• Required Python libraries (pandas, scikit-learn, pyttsx3)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/MediAssist.git
   cd MediAssist
   

2. Install required dependencies:

   pip install -r requirements.txt
   

Usage

1. Execute the main program:

   python diagnostic_system.py
   

2. Follow the on-screen prompts to input your name, age, and symptoms.

3. Receive the assessment results and follow any recommended precautions.

Options

• Email Results: Choose whether to receive the results via email during the assessment.

Code Structure

The MediAssist Diagnostic System codebase is organized as follows:

• Data: Contains training and testing datasets (Data/) and master data for symptom descriptions, severity, and precautions (MasterData/).
• Notebooks: Jupyter notebooks for data exploration and model development.
• Scripts: Python scripts for different functionalities.
  • MediAssist.py: The main script to run the diagnostic system.
  • send_email.py: Functions related to sending assessment results via email.
• Wiki: Documentation and user guides.
• requirements.txt: List of required Python libraries.
• LICENSE: License information for the project.
• README.md: Project overview, setup instructions, and usage guide.

Contributing

Feel free to explore each section for more details on the implementation and usage of the system.

Acknowledgments

We would like to express our gratitude to the following individuals and organizations for their contributions and support:

• scikit-learn for the machine learning tools and libraries used in the project.
• pandas for providing data structures and data analysis tools.
• pyttsx3 for the text-to-speech functionality.
• GitHub for hosting the repository and enabling collaboration.
• The broader open-source community for creating and maintaining the tools and libraries used in this project.

Thank you for the inspiration, guidance, and resources that have been crucial to the development of MediAssist!

Disclaimer

MediAssist is a diagnostic system designed for informational and educational purposes only. It is not a substitute for professional medical advice, diagnosis, or treatment. Always seek the advice of your physician or other qualified health provider with any questions you may have regarding a medical condition.

The system provides general information about potential diseases based on reported symptoms, but it does not consider individual medical histories, allergies, or other specific factors that a healthcare professional would take into account.

Do not disregard professional medical advice or delay seeking medical treatment based on information obtained from MediAssist. If you have a medical emergency, call your doctor or 911 immediately.

The developers and contributors to MediAssist disclaim any liability, loss, or risk incurred as a consequence, directly or indirectly, of the use and application of the system. Use of MediAssist is at your own risk.