ImmuCore is a local-first, privacy-respecting personal health operating system. It is designed to empower individuals to own, manage, and analyze their health, fitness, and physiological data without relying on cloud servers or compromising privacy.
The foundation of ImmuCore is a robust, extensible SQLite data warehouse that currently supports tracking:
- Activities: Workouts, durations, and activity types.
- Sleep Sessions: Sleep duration and quality tracking.
- HRV Readings: Heart Rate Variability tracking for recovery metrics.
- Nutrition Logs: Calorie and macronutrient (protein) tracking.
- Body Metrics: Weight, resting heart rate, and VO2 Max.
- Language: Python 3.9+
- Database: SQLite (Local-first architecture)
- ORM: SQLAlchemy
- Python 3.9 or higher
- A virtual environment manager (
venv,conda, etc.)
-
Clone the repository:
git clone https://github.com/dhruvDev23/immucore.git cd immucore -
Set up a Virtual Environment: Create and activate a virtual environment in the
backenddirectory.python3 -m venv backend/venv source backend/venv/bin/activate # On Windows use `backend\venv\Scripts\activate`
-
Install Dependencies: Install SQLAlchemy and any other requirements.
pip install sqlalchemy
We welcome contributions of all kinds! Whether you are adding new health metric models, building out an API, or designing the frontend, your help is appreciated.
Please see our CONTRIBUTING.md for detailed instructions on how to report bugs, suggest enhancements, and submit Pull Requests.
This project is open-source. Please refer to the LICENSE file for more details.