A comprehensive AI-powered health advisory platform that provides instant symptom analysis, disease prediction, and personalized health recommendations using machine learning algorithms.
The Clinical Guidance System is a web-based healthcare application designed to assist users in identifying potential health conditions based on their symptoms, location, and seasonal factors. The system leverages machine learning models and comprehensive medical datasets to provide accurate disease predictions along with detailed guidance on precautions, medications, dietary recommendations, and exercise routines.
- Symptom Analysis: Input multiple symptoms separated by commas for comprehensive analysis
- Location-Based Predictions: Considers geographical factors that may influence disease prevalence
- Seasonal Analysis: Incorporates current season data for enhanced prediction accuracy
- Voice Input Support: Speech recognition for hands-free symptom entry
- Real-time Predictions: Instant disease prediction with confidence scoring
- Disease Information: Detailed descriptions of predicted conditions
- Precautionary Measures: Evidence-based safety recommendations
- Medication Suggestions: Recommended treatments and medications
- Dietary Advice: Nutritional guidance tailored to specific conditions
- Exercise Recommendations: Physical activity suggestions for recovery and prevention
- Responsive Design: Optimized for desktop, tablet, and mobile devices
- Modern UI/UX: Professional interface with intuitive navigation
- Interactive Elements: Hover effects, animations, and smooth transitions
- Accessibility: Voice input and keyboard navigation support
- Framework: Flask (Python web framework)
- Machine Learning: Decision Tree Classifier
- Data Processing: Pandas for data manipulation
- Logging: Built-in Python logging for system monitoring
- HTML5: Semantic markup structure
- CSS3: Modern styling with CSS Grid and Flexbox
- JavaScript: Interactive features and API integration
- Bootstrap 5.3.1: Responsive framework
- Font Awesome 6.4.0: Icon library
- Google Fonts: Poppins typography
- Algorithm: Support Vector Classifier (SVC)
- Training Data: Comprehensive medical dataset with 19,000+ symptom records
- Prediction Method: Multi-factor scoring based on symptoms, location, and season
- Flask 2.3.3: Web framework for Python
- Pandas 2.1.1: Data manipulation and analysis
- Scikit-learn 1.3.0: Machine learning library
- NumPy 1.24.3: Numerical computing support
Clinical-Guidance-System/
├── dataset/
│ ├── description.csv # Disease descriptions
│ ├── diets.csv # Dietary recommendations
│ ├── disease_info.csv # Disease metadata
│ ├── disease_symptom_summary.csv # Symptom mappings
│ ├── medications.csv # Medication suggestions
│ ├── precautions_df.csv # Safety precautions
│ ├── symtoms_df.csv # Symptoms database
│ ├── updated_training.csv # Training dataset
│ └── workout_df.csv # Exercise recommendations
├── models/
│ ├── medical system.ipynb # Jupyter notebook for model training
│ └── svc.pkl # Trained SVC model
├── static/
│ └── LOGO.png # Application logo
├── templates/
│ ├── index.html # Main application interface
│ ├── about.html # About page
│ ├── blog.html # Blog/documentation
│ ├── contact.html # Contact information
│ └── developer.html # Developer information
├── main.py # Flask application entry point
├── requirements.txt # Python dependencies
└── README.md # Project documentation
- Python 3.7 or higher
- pip (Python package installer)
- Git (for cloning the repository)
-
Clone the repository
git clone https://github.com/yourusername/Clinical-Guidance-System.git cd Clinical-Guidance-System -
Create a virtual environment (recommended)
python -m venv venv # On Windows: venv\Scripts\activate # On macOS/Linux: source venv/bin/activate
-
Install dependencies
pip install -r requirements.txt
Alternative manual installation:
pip install Flask==2.3.3 pandas==2.1.1 scikit-learn==1.3.0 numpy==1.24.3
-
Verify dataset files Ensure all CSV files are present in the
dataset/directory:- description.csv
- diets.csv
- disease_info.csv
- disease_symptom_summary.csv
- medications.csv
- precautions_df.csv
- symtoms_df.csv
- updated_training.csv
- workout_df.csv
-
Run the application
python main.py
-
Access the application Open your web browser and navigate to
http://localhost:5000
Common Issues and Solutions:
-
Module Not Found Error
# Ensure virtual environment is activated pip install -r requirements.txt -
Dataset Files Missing
# Verify all CSV files are in the dataset/ directory ls dataset/ # On Windows: dir dataset\
-
Port Already in Use
# Change port in main.py or kill the process using port 5000 # For Windows: netstat -ano | findstr :5000 # For macOS/Linux: lsof -ti :5000
-
Permission Errors
# On macOS/Linux, you might need: pip install --user -r requirements.txt
- Navigate to the homepage where you'll find the symptom analysis form
- Enter symptoms in the text field, separated by commas (e.g., "headache, fever, cough")
- Select your state/location from the dropdown menu
- Choose the current season (auto-detected but can be modified)
- Optional: Use voice input by clicking the microphone button
- Click "Analyze Symptoms" to get predictions
The system provides comprehensive results including:
- Primary Prediction: Most likely condition based on input data
- Confidence Level: High, Moderate, or Low confidence rating
- Detailed Information: Description, precautions, medications, diet, and exercise
- Home: Main symptom analysis interface
- About: Information about the system and its mission
- Contact: Development team contact information
- Developer: Meet the development team
- Blog: Technical documentation and system insights
The system uses a multi-factor scoring algorithm that considers:
-
Symptom Matching (70% weight)
- Compares user symptoms against disease-specific symptom profiles
- Calculates match percentage based on known symptom associations
-
Location Factor (15% weight)
- Considers geographical disease prevalence
- Accounts for regional health patterns and endemic conditions
-
Seasonal Factor (15% weight)
- Incorporates current season in disease likelihood
- Accounts for seasonal health patterns and climate-related conditions
- High Confidence: Score > 0.5 (Strong symptom match with location/season alignment)
- Moderate Confidence: Score 0.2-0.5 (Partial symptom match)
- Low Confidence: Score < 0.2 (Limited symptom correlation)
The system utilizes multiple comprehensive datasets:
- Disease Information: 43 medical conditions with metadata
- Symptom Database: 4,900+ symptom records across various conditions
- Training Data: 1.4MB dataset with validated symptom-disease mappings
- Treatment Data: Evidence-based recommendations for medications, diet, and exercise
- No personal health information is stored
- All processing occurs locally during the session
- No data is transmitted to external services
- Praveen Kumar: Data Science Student & AI Enthusiast
- Arun Nivesh: Data Science Student & Tech Innovator
- Email: praveenrajagopal45@gmail.com
- Email: kit26.ad16@gmail.com
- Phone: +91 97862 92689
- Phone: +91 87789 29228
- Location: Coimbatore, Tamil Nadu, India
- This system is for educational and informational purposes only
- Predictions are not a substitute for professional medical advice
- Always consult qualified healthcare professionals for medical decisions
- Do not use this system for emergency medical situations
- The developers are not responsible for any medical decisions based on system output
- Predictions are based on machine learning models and may not be 100% accurate
- System performance depends on the quality and completeness of input data
- Results should be considered as preliminary guidance only
- Response Time: < 2 seconds for symptom analysis
- Supported Browsers: Chrome, Firefox, Safari, Edge
- Mobile Compatibility: Responsive design for all screen sizes
- Concurrent Users: Suitable for educational and demonstration purposes
- Server: Python 3.7+, 512MB RAM minimum
- Client: Modern web browser with JavaScript enabled
- Network: Standard internet connection for CDN resources
- Integration with additional medical databases
- Multi-language support for broader accessibility
- Enhanced machine learning models with deep learning
- User account system for symptom tracking
- Integration with wearable health devices
- Telemedicine consultation scheduling
- Natural language processing for symptom description
- Computer vision for symptom-related image analysis
- Personalized health recommendations based on user history
- Real-time epidemic tracking and alerts
This project is developed as an educational initiative by data science students. Please contact the development team for licensing and usage permissions.
Special thanks to the medical community for providing the foundational knowledge and datasets that make this system possible. This project represents our commitment to leveraging technology for improved healthcare accessibility and awareness.
Version: 1.0.0
Last Updated: 2024
Status: Active Development
For technical support or collaboration inquiries, please contact the development team using the information provided above.