How astreonix/cardioai works
CardioAI is a Flask heart-disease risk assessment platform. A user submits 13 clinical fields; the app validates them, prepares features, runs the trained model, presents a risk result with SHAP explanations, and records the assessment. Users can review assessment history, ask Gemini contextual questions, and download PDF reports. The runtime is concentrated in app.py, so several distinct responsibilities share that source path. README capabilities fill gaps where route implementation excerpts were omitted; unsampled implementation details are not inferred.
Main entry points: app.py Flask routes · predict.html Assessment form · history.html History dashboard · chat.html Chat page
Components 15
User experience
- Flask routes
app.py - Assessment form
templates/predict.html - History dashboard
templates/history.html - Chat page
templates/chat.html
Risk assessment
- Input validation
app.py - Feature preparation
app.py - Feature scaler
models/scaler.pkl - Risk classifier
models/cardioai_model.pkl - SHAP explanations
app.py
Assessment records
- SQLite records
app.py - History queries
app.py - PDF reports
app.py
Follow-up assistance
- Gemini service
- Chat handling
app.py
Other components
- User
Connections 24
- User → Assessment form: enters data
README.md - Assessment form → Flask routes: submits assessment
README.md - Flask routes → Input validation: validates input
app.py - Flask routes → Feature preparation: builds features
app.py - Flask routes → Feature scaler: transforms features
app.py - Flask routes → Risk classifier: predicts risk
app.py - Flask routes → SHAP explanations: generates explanations
README.md - Flask routes → SQLite records: saves assessment
app.py - Flask routes → Assessment form: renders form
README.md - User → History dashboard: reviews history
README.md - History dashboard → Flask routes: requests history
README.md - Flask routes → History queries: queries records
README.md - History queries → SQLite records: reads assessments
README.md - Flask routes → History dashboard: renders history
README.md - User → Chat page: opens chat
README.md - Chat page → Flask routes: sends message
README.md - Flask routes → Chat handling: handles message
app.py - Chat handling → SQLite records: loads context
app.py - Chat handling → Gemini service: requests reply
README.md - Chat handling → SQLite records: stores messages
app.py - User → Flask routes: requests report
README.md - Flask routes → SQLite records: loads assessment
README.md - Flask routes → PDF reports: generates PDF
README.md - PDF reports → SQLite records: logs report
app.py