HeartRisk AI

Heart disease is the leading cause of death globally, yet people often don't understand their risk level, ignore early warning signs, and don't know what questions to ask their doctor. Most online tools provide static risk calculators that don't explain why risk is high or offer personalized preventive guidance.

An AI-powered system that collects key health indicators, predicts heart disease risk using ML, and provides explainable guidance and next steps. The LLM layer generates patient-friendly explanations of model predictions, personalized preventive guidance, and structured questions to bring to doctor visits.

• User enters key health indicators
• ML model predicts heart disease risk
• LLM generates a patient-friendly explanation of the prediction
• System provides personalized preventive guidance
• Output includes structured questions to ask the doctor

• Patient-friendly explanation — translates ML predictions into plain language
• Preventive guidance generation — personalized lifestyle and follow-up suggestions
• Doctor-visit question generation — structured prompts based on predicted risk
• Medical terminology simplification

• ML: Python, scikit-learn / XGBoost, SHAP for feature importance
• Backend: FastAPI
• LLM: Claude API or Ollama (Llama 3 / Mistral) for the explanation layer
• Frontend: React