# Pulse

> Open source, self-hosted health scores from Google Health API data, built and tested on Fitbit Air.

Pulse shows Recovery, Strain, Sleep Performance, Pulse Age, Stress, Energy Bank, training insights, journal insights and a configurable AI coach. Its scores are wellness estimates, not medical diagnoses. Missing data is shown honestly; baselines use earlier days only.

Canonical page: https://pulse.portlabs.in/

## Run Pulse

- [Setup guide](https://github.com/adityaongit/pulse/blob/main/docs/setup.md)
- [Source code](https://github.com/adityaongit/pulse)
- [PolyForm Noncommercial 1.0.0 license](https://github.com/adityaongit/pulse/blob/main/LICENSE)

Your health data is stored in your own Postgres database. Google access requires your own OAuth client. The optional coach sends the context needed to answer to the AI provider you configure.

## Scores

- [Recovery](https://pulse.portlabs.in/metrics/recovery/index.md): How ready your body is to take on strain today, from 0 to 100%.
- [Strain](https://pulse.portlabs.in/metrics/strain/index.md): The cardiovascular load of your day, on a scale from 0 to 21.
- [Strain Target](https://pulse.portlabs.in/metrics/strain-target/index.md): A Strain range for today, set by your Recovery and recent load.
- [Sleep Performance](https://pulse.portlabs.in/metrics/sleep-performance/index.md): How well last night’s sleep met your need, from 0 to 100%.
- [Sleep Planner](https://pulse.portlabs.in/metrics/sleep-planner/index.md): Tonight’s sleep need, and the bedtimes that meet it.
- [Pulse Age](https://pulse.portlabs.in/metrics/pulse-age/index.md): How old your body behaves, and how fast that is changing.
- [Stress Monitor](https://pulse.portlabs.in/metrics/stress-monitor/index.md): How far your heart rate sits above your calm level, from 0 to 3.
- [Energy Bank](https://pulse.portlabs.in/metrics/energy-bank/index.md): An estimate of how much energy you have left today, 0 to 100%.
- [Health Monitor](https://pulse.portlabs.in/metrics/health-monitor/index.md): Last night’s five vitals against your own normal ranges.
- [Fitness level](https://pulse.portlabs.in/metrics/fitness-level/index.md): Your VO2 max compared with people of your age and sex.
- [Training balance](https://pulse.portlabs.in/metrics/training-balance/index.md): Whether your recent strain is above or below what you are used to.
- [Behaviour insights](https://pulse.portlabs.in/metrics/behaviour-insights/index.md): How each behaviour you log goes with your next day’s scores.
- [Sleep consistency](https://pulse.portlabs.in/metrics/sleep-consistency/index.md): How closely your sleep and wake times repeat from day to day.
- [Fitness, fatigue and form](https://pulse.portlabs.in/metrics/fitness-fatigue-form/index.md): Your long-term and short-term training load, and the gap between them.
- [Heart rate recovery](https://pulse.portlabs.in/metrics/heart-rate-recovery/index.md): How far your heart rate drops in the minute after a workout.
- [Heart rate variability (HRV)](https://pulse.portlabs.in/metrics/hrv/index.md): The night-to-night signal Recovery leans on most, read from your Google Health data.
- [Resting heart rate](https://pulse.portlabs.in/metrics/resting-heart-rate/index.md): Your lowest sleeping heart rate, and the vital most scores lean on.

## Compare

- [Does the Fitbit Air have strain and recovery scores?](https://pulse.portlabs.in/compare/fitbit-air-recovery-and-strain/index.md): The Google Health app gives Fitbit Air owners Readiness and Cardio Load, not a 0-100% Recovery or a 0-21 Strain. How to get both, free and self-hosted.
- [Pulse and subscription recovery wearables, compared](https://pulse.portlabs.in/compare/pulse-vs-subscription-wearables/index.md): Pulse on a Fitbit Air next to a recovery wearable sold with a membership: which scores each has, how you pay, where the data lives, and who each suits.
- [Recovery and strain tracking without a subscription](https://pulse.portlabs.in/compare/recovery-tracking-without-subscription/index.md): Open-source, subscription-free ways to get recovery, strain and sleep scores: Pulse for the Fitbit Air, plus noop, Hælan and fitbit-grafana.
- [Google Health Premium, WHOOP and Pulse: what each adds](https://pulse.portlabs.in/compare/google-health-premium/index.md): What a Fitbit Air does free, what Google Health Premium adds, how a WHOOP membership compares on price, and what Pulse computes on top.
- [Fitbit Air vs Garmin Cirqa: the scores compared](https://pulse.portlabs.in/compare/fitbit-air-vs-garmin-cirqa/index.md): Two screenless bands: what Garmin's Body Battery and Training Readiness and Fitbit Air's Readiness and Cardio Load measure, and where they differ.
- [Fitbit Air vs Amazfit Helio Strap: the scores compared](https://pulse.portlabs.in/compare/fitbit-air-vs-amazfit-helio-strap/index.md): Two screenless, subscription-optional bands: what Fitbit Air's Readiness and Cardio Load and Amazfit's BioCharge and PAI measure, and where they differ.
- [Fitbit Air vs Oura Ring: sleep and readiness](https://pulse.portlabs.in/compare/fitbit-air-vs-oura-ring/index.md): Oura's Readiness and Sleep scores against Fitbit Air's Daily Readiness and Sleep Score: what goes into each, how they are explained, and the cost of each.
- [Google Health app vs Garmin Connect, as dashboards](https://pulse.portlabs.in/compare/google-health-vs-garmin-connect/index.md): The Google Health app and Garmin Connect as dashboards: which scores each shows, what is free, what is paid, and where a separate app like Pulse adds to them.
- [Pixel Watch vs WHOOP: scores, cost and data](https://pulse.portlabs.in/compare/pixel-watch-vs-whoop/index.md): A smartwatch with Google Health scores against a recovery band on a membership: what Readiness and Cardio Load do, what Recovery and Strain do, and the cost.
- [How each brand builds its recovery or readiness score](https://pulse.portlabs.in/compare/recovery-scores/index.md): Google Health, WHOOP, Garmin, Amazfit, Oura, Samsung, Apple and Pulse: the recovery or readiness score each builds, and the inputs each vendor says it uses.
