Skip to content

tmuchlissin/cardiolytics-home-care

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

49 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Cardiolytics Home Care

Cardiolytics Logo

Integrated Cardiovascular Monitoring and Prediction System

Cardiolytics is a smart and scalable web-based health monitoring system that integrates real-time IoT devices, ensemble learning models, and a document-grounded AI chatbot to support cardiovascular homecare and predictive health services.

πŸ–ΌοΈ System Preview

Web Screenshot

Example UI: Landing Page Cardiolytics

βš™οΈ Key Features

✨ Integrated Monitoring System β€” Comprehensive blood pressure monitoring using ESP32 (with simulated data), EMQX, and Kafka.

🧠 Hybrid Ensemble Model β€” Cardiovascular risk prediction powered by advanced ensemble models.

πŸ’¬ Document-aware Chatbot β€” Intelligent Q&A chatbot leveraging PDF documents with Gemini and Pinecone integration.

πŸ‘₯ Role-based Access β€” Secure, role-specific access for Patients and Admins with authentication support.

πŸ›  Tech Stack β€” Flask, Jinja, MySQL, MQTT, Node-RED, and more.

πŸš€ Quick Start

πŸ“ Clone the Repository

git clone https://github.com/tmuchlissin/cardiolytics_home_care.git
cd cardiolytics_home_care

🐍 Set Up Python Environment

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt          # Core Flask environment
pip install -r requirements_el.txt       # Optional: Ensemble model dependencies

πŸ““οΈ Configure Database

flask db init
flask db migrate
flask db upgrade

πŸ”Œ Flash Firmware to ESP32

  • Open src/esp_simulator.ino in Arduino IDE
  • Flash to ESP32 device
  • Ensure .env MQTT credentials are correct

πŸ” Set Up Node-RED Flow

  • Go to http://localhost:1880
  • Import flow from src/flows.json

πŸ–₯️ Run the Application

export FLASK_APP=backend/app.py
export FLASK_ENV=development
flask run

🌐 Visit: http://localhost:5000

🧽 System Architecture

System Architecture

High-level Workflow of Cardiolytics System

πŸ“ License

This project is licensed under the MIT License Β© 2025 T. Muchlissin

πŸ™Œ Acknowledgements

πŸ’¬ For research collaboration or demo requests, feel free to open an issue or contact me via GitHub.

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published