sandseb123

Leo-Health-Core: Unify Apple Health and Whoop Data Locally

Leo-Health-Core is a Python tool that parses Apple Health exports and Whoop CSVs into a normalized SQLite database. It keeps health data on your machine and provides a terminal view, local dashboard, and automatic import watcher.

View on GitHub Compare
Stars
94
Forks
9
Stars, last 30 days
+1
Last commit
7 months ago
Contributors
2

Our take

Quietno commits in the last 90 days

Health score

27/100

How it is scored
Activity
31
Community
36
Issues
21
Pull requests
20

+1 stars in the last 30 days

  • Fewer contributors than 86% of the projects we track

This is a focused, privacy-oriented health data importer with a useful local workflow, but its recent quiet period and small, concentrated contributor base call for caution before relying on it as a maintained foundation.

Good fit if

  • You want Apple Health and Whoop exports in SQLite and are comfortable using Python, SQL, or a terminal.
  • Keeping wearable data on your own machine is important, and Docker suits your Linux or Windows setup.
  • The current import formats and single-user local dashboard meet your needs; the project is MIT licensed.

Look elsewhere if

  • You need an actively maintained project with recent changes or prompt issue and pull request handling.
  • You need Oura, Fitbit, or Garmin imports now, rather than planned support.
  • You need a hosted, multi-user service or dashboard authentication.
All health signals
Last commit2026-03-21 (7 months ago)
Commits, last 90 days0
Releases, last 12 months1 (latest v0.1.0, 2026-02-28)
Contributors2 (top contributor: 58% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age8 months

Checked on 2026-10-15 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

95

Forks

9

Change since Nov 17, 2026: 0 stars·0 forks

Overview

Leo-Health-Core uses Python and SQLite to turn Apple Health exports and Whoop CSV files into one normalized, locally stored database. It addresses the problem of health metrics being split across a large Apple Health XML export and Whoop files with inconsistent columns, making the data queryable with standard SQL.

It is aimed at developers comfortable with the terminal who want to inspect wearable data without sending it to a network service. The project supports macOS directly and documents Docker use for macOS, Linux, and Windows.

Key Features

  • Parses Apple Health export ZIPs, including heart rate, HRV, sleep, workouts, and blood oxygen.
  • Imports Whoop CSV data for recovery, strain, and sleep.
  • Normalizes data into SQLite tables that can be queried with ordinary SQL.
  • Provides a terminal dashboard and a local web dashboard.
  • Watches the Downloads folder for new exports and can ingest them automatically.
  • Offers Docker Compose support and documents persistent database storage.
  • States that it makes no outbound network requests and stores data locally.

Use Cases

  • Apple Watch users can combine exported heart rate, sleep, workout, and HRV records for SQL-based analysis.
  • Whoop users can query recovery and strain history alongside other health records.
  • Developers comparing measurements across Apple Health and Whoop can inspect normalized records by source.
  • People who want automatic local imports can use the watcher when exporting or AirDropping health files to their Mac.

What you need

Detected in the repository

  • Python >=3.9 (from pyproject.toml)
  • A Dockerfile, so it can run in a container; a Compose file sets up the related services
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

git clone https://github.com/sandseb123/Leo-Health-Core.git
cd Leo-Health-Core
pip3 install -e .

See the README for Docker setup, export instructions, and usage details.

Considerations

The project is marked quiet, with no commits in the last 90 days despite a release in the past year. There are two contributors, and most contributions come from one person; the measured data also shows no recent issue closures or merged pull requests. Teams adopting it should plan to review and test changes themselves.

The documented importers cover Apple Health and Whoop, while Oura, Fitbit, and Garmin support remain on the roadmap. The dashboard is designed for single-user desktop use, binds to localhost, and has no authentication. Python 3.9 or newer is required for a direct install; Docker and Docker Compose are alternatives.

Found this useful?

Share it with someone who would like Leo-Health-Core.

Comparisons