whatisgithub

What is apple-watch?

tangka/apple-watch — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A Python tool that turns your Apple Health export into a self-contained HTML report comparing 20+ health metrics against medical guideline benchmarks.

Mindmap

mindmap
  root((apple health report))
    What it does
      Parses Health export
      Builds HTML report
      Benchmarks against guidelines
      Composite health score
    Tech stack
      Python
      HTML
    Use cases
      Personal health review
      Sleep and heart rate analysis
      Claude Code skill
    Audience
      Apple Watch users
      Health-conscious individuals

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a personal health report from your Apple Watch or iPhone Health export.

USE CASE 2

Compare your sleep, heart rate, and fitness metrics against published medical guideline thresholds.

USE CASE 3

Trigger the analysis as a Claude Code skill with a natural-language prompt instead of running scripts manually.

USE CASE 4

Review a composite health score and letter grade across key metrics.

What is it built with?

PythonHTML

How does it compare?

tangka/apple-watcha-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/53/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires exporting your own Health app ZIP file and running two local Python scripts.

Permissive open-source license, use freely for any purpose including commercial use, as long as you keep the copyright notice.

So what is it?

Apple Health Report is a Python tool that converts an Apple Watch or iPhone Health data export into a self-contained HTML report, comparing your metrics against peer-reviewed benchmarks. You export your data from the iPhone's Health app as a ZIP file, run two Python scripts, one to parse the XML data and one to build the report, and open the resulting HTML file in any browser. The report covers more than 20 metrics including step counts, exercise minutes, resting heart rate, heart rate variability (HRV), VO2max, a measure of aerobic fitness, sleep duration and stages (Deep, REM, Core, Awake), blood oxygen (SpO2), and respiratory rate. Each metric is compared against age and sex adjusted thresholds sourced from AHA, WHO, AASM, ACSM, and ESC guidelines, with citations linking to the original studies. A composite health score gives a weighted letter grade across six key metrics. All processing happens locally, and nothing is sent anywhere. The HTML file is fully self-contained with no external dependencies once generated, and the only network activity is a one-time download of a charting library on first run. The repository excludes raw and parsed data directories from version control to prevent accidental upload of personal health data. The tool can also work as a Claude Code skill, letting you trigger the full analysis by typing a natural-language prompt rather than running the scripts manually. The report supports seven languages, English, Chinese, Spanish, French, German, Japanese, and Korean, with automatic detection, adapts to light or dark mode, and carries a not medical advice disclaimer in every language. It is MIT licensed.

Copy-paste prompts

Prompt 1
Walk me through exporting my Apple Health data and running this tool to generate my HTML report.
Prompt 2
Explain what my HRV and VO2max results mean based on the benchmarks this tool cites.
Prompt 3
How do I set up this project as a Claude Code skill to analyze my health export?
Prompt 4
What do I need to check to make sure my raw health data isn't accidentally committed to version control?

Frequently asked questions

What is apple-watch?

A Python tool that turns your Apple Health export into a self-contained HTML report comparing 20+ health metrics against medical guideline benchmarks.

What language is apple-watch written in?

Mainly Python. The stack also includes Python, HTML.

What license does apple-watch use?

Permissive open-source license, use freely for any purpose including commercial use, as long as you keep the copyright notice.

How hard is apple-watch to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is apple-watch for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.