How nisheelmodi/healthsense-ai works
HealthSense AI is a web-based cardiovascular risk assessment tool. A user enters personal, lifestyle, and symptom information in the guided wizard; the frontend submits it to FastAPI, which returns a prediction for the results page to display with risk factors and wellness recommendations. The README documents the backend’s ML inference flow and the CDC BRFSS training pipeline. Backend source was listed as read but not excerpted, so internal API-to-model details are shown only where documented, not inferred from unsampled implementation.
Main entry points: AssessmentWizard.tsx Assessment wizard · page.tsx Results page · main.py FastAPI prediction API · train.py Model training
Components 21
Web experience
- Home page
src/app/page.tsx - Navigation
src/components/Navbar.tsx - Results page
src/app/result/page.tsx - Risk score display
src/components/ResultCard.tsx - Risk summary
src/components/SummaryCard.tsx - Recommendations
src/components/RecommendationCard.tsx - Medical disclaimer
src/components/DisclaimerCard.tsx
Assessment flow
- Assessment page
src/app/assessment/page.tsx - Assessment wizard
src/components/AssessmentWizard.tsx - Personal details
src/components/PersonalInfoStep.tsx - Lifestyle details
src/components/LifestyleStep.tsx - Symptoms
src/components/SymptomsStep.tsx - Step progress
src/components/AssessmentProgress.tsx - Step controls
src/components/AssessmentNavigation.tsx - Loading state
src/components/LoadingScreen.tsx
Prediction service
- FastAPI prediction API
backend/main.py - Fallback risk scoring
src/lib/riskCalculator.ts
Machine learning
- Model training
ml/src/train.py - Dataset preprocessing
ml/src/preprocess.py - Trained model artifacts
ml/models
Other components
- User
Connections 21
- User → Home page: opens
README.md - Navigation → Assessment page: links to
src/components/Navbar.tsx - Assessment page → Assessment wizard: renders
src/app/assessment/page.tsx - Assessment wizard → Personal details: renders
src/components/AssessmentWizard.tsx - Assessment wizard → Lifestyle details: renders
src/components/AssessmentWizard.tsx - Assessment wizard → Symptoms: renders
src/components/AssessmentWizard.tsx - Assessment wizard → Step progress: renders
src/components/AssessmentWizard.tsx - Assessment wizard → Step controls: renders
src/components/AssessmentWizard.tsx - Assessment wizard → Loading state: shows
src/components/AssessmentWizard.tsx - Assessment wizard → FastAPI prediction API: POSTs assessment
src/components/AssessmentWizard.tsx - FastAPI prediction API → Trained model artifacts: predicts with
README.md - FastAPI prediction API → Assessment wizard: returns results
README.md - Assessment wizard → Results page: routes to
README.md - Results page → Fallback risk scoring: calculates fallback
src/app/result/page.tsx - Results page → Risk score display: renders score
src/app/result/page.tsx - Results page → Risk summary: renders summary
src/app/result/page.tsx - Results page → Recommendations: renders advice
src/app/result/page.tsx - Results page → Medical disclaimer: renders disclaimer
src/app/result/page.tsx - Model training → Dataset preprocessing: loads processed data
ml/src/train.py - Dataset preprocessing → Model training: returns datasets
ml/src/train.py - Model training → Trained model artifacts: produces artifacts
README.md