The Cardiovascular Disease Prediction AI project is an open-source initiative aimed at developing an AI-powered chatbot that predicts the probability of an individual having a cardiovascular disease based on user-provided inputs. The project utilizes machine learning techniques and a pre-trained model to provide users with an estimate of their likelihood of developing a cardiovascular disease in the present or future.
The motivation behind this project is to address the significant impact of heart diseases, which rank among the top three causes of death worldwide. Often, patients realize the presence of cardiovascular diseases at a late stage, resulting in limited treatment options. The project aims to empower users to self-assess their risk and make informed decisions about seeking medical checkups and interventions.
The project utilizes the following technologies: AWS (Amazon Web Services): Cloud infrastructure and services Python: Programming language for machine learning and data processing
The project repository follows a well-organized structure to ensure clarity and ease of use. The repository contains the following components:
Architecture-Diagram/: This directory contains the source code for the AI chatbot and machine learning model.
Data/: This directory stores the datasets used for training and evaluation. It also includes any necessary preprocessing scripts or data cleaning tools.
Solution-Component/: This directory holds the pretrained machine learning models used for cardiovascular disease prediction.
docs/: This directory contains project documentation and additional resources.
README.md: The main documentation file providing an overview of the project, installation instructions, and usage guidelines.
CONTRIBUTING.md: Guidelines for contributing to the project.
LICENSE: The license file specifying the open-source license under which the project is released.
CHANGELOG.md: A log of changes made to the project over time.
API_DOCUMENTATION.md: Documentation for the API endpoints and usage.
Additional files and directories as required for project documentation.
tests/: This directory contains unit tests and test scripts to ensure the correctness and reliability of the codebase.
requirements.txt: A file specifying the Python dependencies required to run the project.
.gitignore: A file specifying which files and directories should be ignored by version control.
LICENSE: The project's open-source license file.
README.md: This file, providing an overview of the project and its structure.
To run the Cardiovascular Disease Prediction AI project locally, follow these steps:
- Clone the project repository:
git clone https://github.com/AI-MediSphere/PredictionModel.git
cd AI-MediSphere- Install the required dependencies using pip:
git clone https://github.com/AI-MediSphere/PredictionModel.git
cd AI-MediSphere- Run the AI chatbot using the provided command-line interface (CLI) or by integrating the API into your own application.
pip install -r requirements.txtThe Cardiovascular Disease Prediction AI project offers two main ways to interact with the prediction model:
Examples of prompts and chatbot responses
No risk
Hello, Mary Sue! Based on the information you provided, I'm glad to inform you that you are currently at a lower risk of heart disease. Let's explore each factor that contributes to your positive health profile:
Age: At 25 years old, you are at an age where heart diseases are less common. However, it's still important to maintain a healthy lifestyle to prevent future risks.
Gender: Being female typically provides certain cardiovascular advantages, resulting in a lower risk of heart disease compared to males.
Body Measurements: Your height of 1.80m and weight of 70kg indicate a healthy body mass index (BMI), which suggests that you are within a desirable weight range.
Blood Pressure: Your blood pressure readings of 100/80 mmHg (high/low) fall within the normal range, indicating a healthy blood pressure level.
Cholesterol Levels: Having low cholesterol levels implies that you have a decreased risk of plaque buildup in your arteries, reducing the likelihood of heart disease.
Blood Glucose Level: A normal blood glucose level indicates that you have a well-regulated metabolism, which contributes to a lower risk of heart disease.
Smoking: Not smoking is a significant advantage since smoking is a major risk factor for heart disease. Your decision to abstain from smoking protects your heart health.
Alcohol Consumption: Avoiding alcohol consumption is beneficial, as excessive alcohol intake can elevate blood pressure and increase the risk of heart disease.
Physical Activity: Engaging in regular physical activity is excellent for heart health. Your commitment to regular exercise strengthens the heart, improves blood flow, and lowers the risk of heart disease.
Given your positive health profile, you are not currently at high risk for heart disease. However, it's still essential to maintain a healthy lifestyle, including regular exercise, a balanced diet, and routine health check-ups. By prioritizing these aspects, you can continue to safeguard your heart health and overall well-being. If you have any concerns or experience changes in your health, it's always wise to consult a doctor for personalized guidance. Keep up the good work in taking care of yourself!
Risk - uneducated (young) user
Hello John Doe! I'm here to discuss an important matter related to your health. Based on the information you provided, there are several factors that indicate you may be at a high risk of heart disease. Let's take a closer look at each risk factor:
Age: Being 18 years old doesn't guarantee protection against heart diseases. While it's less common at a young age, certain risk factors can still contribute to heart problems.
Gender: Men, like you, have a higher risk of heart disease due to biological and lifestyle factors.
Body Measurements: Your height of 1.80m and weight of 95kg indicate that your body mass index (BMI) is higher than the recommended range. This suggests that you might be carrying excess weight, which can strain your heart and increase the risk of heart disease.
Blood Pressure: Your high blood pressure reading of 150 and low blood pressure reading of 120 are both concerning. Consistently elevated or fluctuating blood pressure levels can damage your blood vessels, putting you at a higher risk of heart disease.
Cholesterol Levels: High cholesterol levels can lead to the buildup of plaque in your arteries, restricting blood flow and increasing the risk of heart disease.
Blood Glucose Level: High blood glucose levels suggest that you may have elevated blood sugar. This can contribute to the development of diabetes, which in turn increases the risk of heart disease.
Smoking: Smoking is extremely harmful to your heart and blood vessels. The chemicals in cigarettes damage the arteries, increase blood pressure, and elevate the risk of heart disease.
Alcohol Consumption: Excessive alcohol consumption, such as drinking several glasses per day, can lead to high blood pressure, irregular heart rhythms, and other heart-related problems.
Physical Inactivity: Not engaging in regular physical activity puts you at a higher risk of heart disease. Exercise helps maintain a healthy weight, lower blood pressure, and improve overall cardiovascular health.
Considering all these risk factors, it is crucial for you to consult a doctor as soon as possible. They can evaluate your health comprehensively, conduct necessary tests, and provide personalized guidance to manage and mitigate these risks effectively. Taking proactive steps and seeking medical advice will greatly improve your chances of preventing heart disease. Your health is important, so please prioritize it by consulting a doctor promptly.
Risk - experienced and adult user
Dear Mr. John Doe, based on the provided information, I must emphasize that your current health profile places you at a significantly high risk of heart disease. Allow me to elaborate on each risk factor and its potential detrimental effects:
Age: At 58 years old, the risk of developing heart disease tends to increase due to the natural aging process and cumulative exposure to various risk factors over time.
Gender: Being male, you are more predisposed to heart diseases compared to females, as hormonal and genetic factors contribute to a higher prevalence.
Body Measurements: With a height of 1.80m and a weight of 95kg, your body mass index (BMI) indicates that you are overweight. Excessive weight puts strain on your heart and elevates the risk of cardiovascular complications.
Blood Pressure: Your blood pressure readings of 150/120 mmHg (high/low) demonstrate hypertension, a condition that burdens the heart and blood vessels, potentially leading to heart disease, stroke, and organ damage.
Cholesterol Levels: Elevated cholesterol levels, especially if your low-density lipoprotein (LDL) cholesterol is high, promote the deposition of fatty plaques in arterial walls, obstructing blood flow and heightening the likelihood of heart diseases.
Blood Glucose Level: High blood glucose levels suggest impaired glucose regulation, potentially indicating diabetes or prediabetes. Elevated blood sugar levels contribute to the development of atherosclerosis, increasing the risk of heart disease.
Smoking: Smoking is a significant risk factor that damages the inner lining of blood vessels, accelerates the formation of arterial plaques, and raises blood pressure, significantly increasing the likelihood of heart disease.
Alcohol Consumption: Consuming several glasses of alcohol per day contributes to high blood pressure, irregular heart rhythms, and weakening of heart muscles, augmenting the risk of heart diseases.
Physical Inactivity: The absence of regular physical activity reduces cardiovascular fitness, weakens the heart muscle, and impairs overall heart health, increasing the susceptibility to heart diseases.
Considering these multiple risk factors, I strongly urge you to promptly consult a doctor. Medical professionals can assess your specific circumstances, conduct comprehensive evaluations, and develop a personalized plan to manage and mitigate these risks. By taking proactive measures and seeking professional guidance, you can significantly improve your cardiovascular health and reduce the chances of heart disease. Your well-being is paramount, so please prioritize your health and seek medical attention without delay.
Contributions are always welcome!
See contributing.md for ways to get started.
Please adhere to this project's code of conduct.
Welcome to our team of dedicated individuals who are passionate about making a positive impact in the healthcare industry. We are a group of enthusiastic and skilled professionals committed to leveraging the power of technology to improve the lives of individuals affected by cardiovascular diseases.
At our core, we believe that early detection and prevention are key to reducing the prevalence and severity of cardiovascular diseases, which continue to be a leading cause of mortality worldwide. Our mission is to empower individuals to take charge of their cardiovascular health through accessible and accurate risk assessment.
Combining our expertise in artificial intelligence, machine learning, and cloud technologies, we have embarked on the development of AI-Medisphere™ - The Cardiovascular Prognosticator. This state-of-the-art AI-driven solution aims to provide users with a reliable and user-friendly tool to assess their risk of developing cardiovascular diseases both now and in the future.
Our team consists of diverse professionals with specialized skills. From cloud architects and machine learning experts to data engineers and cloud implementation engineers, we bring together a range of expertise to create a robust and scalable solution. Together, we strive to deliver an exceptional product that not only meets the highest standards of accuracy but also provides a seamless user experience.
We understand the critical importance of collaboration and knowledge sharing in the field of healthcare. That's why we have chosen to make our project open-source, allowing developers, researchers, and healthcare professionals from around the world to contribute, learn, and benefit from our work. We believe that by fostering a collaborative community, we can accelerate advancements in cardiovascular disease prediction and ultimately improve patient outcomes.
Join us on this exciting journey as we work towards a future where cardiovascular diseases are detected early, interventions are timely, and lives are saved. Together, let's make a difference in the world of healthcare.
Govind Kumar - Cloud Architect @elngovind
Ermanno B.J. Attardo - ML Lead @Attersson
Ahmed Ali - Data Engineer @ahmedmagdy31
Feel free to reach out to any of our team members with questions, suggestions, or collaboration opportunities. We are always excited to connect with like-minded individuals who share our passion for transforming healthcare through innovative technologies.
Our vision is to create a future where individuals have the knowledge and tools to proactively manage their cardiovascular health. We strive to empower users with accurate and personalized risk assessments, enabling them to make informed decisions about their well-being. By leveraging cutting-edge technologies and collaborative efforts, we aim to contribute to a world where cardiovascular diseases are not only better understood but also preventable and treatable.
We would love to hear from you! If you have any questions, feedback, or collaboration inquiries, please don't hesitate to reach out to us:
Email: contact@axcess.io
Website: www.axcess.io
Twitter: @axcess.io
LinkedIn: Axcessio
Thank you for your support, and let's revolutionize cardiovascular disease prediction together!