adityaongit/pulse

your fitbit air, but it finally tells you why you feel like garbage. recovery, strain, sleep and a Pulse Age that judges you, all free and self-hosted.

Rising85NewTypeScriptNo license Last commit 2 days ago pulse.portlabs.in

Open on GitHub

Last 24 hours: +9; stars
Last 7 days: +86; 3× its usual pace
Last 30 days: +122; stars
Total stars: 122; created 14 days ago
Forks: 27; 5 contributors

Star history

Last 12 weeks · weekly cumulative stars · created Oct 3, 2026, zero before · computed from public GitHub star events

Why it’s rising: #29 in Self-hosted this week · 3× its usual pace

Rank in its topics

Position among repos ranked in each topic (min. 20 stars gained)

Rank of adityaongit/pulse in each topic for today, this week and this month
Topic	Today	This week	This month
Self-hosted	–	#29of 188	#72of 320
TypeScript	–	#114of 567	#239of 837

Health signals

Too new to assessChecked Oct 15, 2026

Too new to assess: the repository is less than 60 days old or has fewer than 10 commits. The signals below are shown for information only.

Commit activity: Commits in 2 of the last 3 weeks 354 commits on the default branch in 90 days
Maintainers: 4 active maintainers Top author: 92% of the last 100 commits
Issue responsiveness: Median first response: 4 hours 3 of 5 issues opened in 90 days are closed
Pull requests: 19 merged, 7 closed, 2 open Of 28 pull requests opened in 90 days
Releases: No GitHub releases Not counted: many projects ship without them
Project hygiene: License, CI and security policy
OpenSSF Scorecard: Not scanned Unknown, not counted against the project

Signals are computed automatically from public GitHub data. They are not an endorsement or a security audit. How health is computed

README

README.md

Pulse

Recovery, strain and sleep from your Google Health data.

Daily scores from what your Fitbit or Pixel Watch syncs to Google Health. Built on Fitbit Air, free for personal use.

Get Pulse

Self-host: one Docker container with Postgres behind HTTPS, for you and the people you invite. The setup guide walks through Google Cloud, Docker and Tailscale.

Android: Pulse Mobile needs no server or account and scores everything on your phone, from Health Connect.

What you get

Sleep, Recovery and Strain every morning, with a Strain Target for the day
Pulse Age, Stress Monitor and Energy Bank through the day
Health Monitor, Journal, Trends, Reports, My Dashboard and an optional AI coach with your own key

Every score is explained on the metrics pages and in docs/algorithms. More screens: docs/screenshots.md.

Try the demo

No Google account needed: demo mode generates 180 days of data.

git clone https://github.com/adityaongit/pulse.git && cd pulse
pnpm install && cp .env.example .env
docker compose -f compose.dev.yaml up -d && pnpm dev    # http://localhost:3000

Documentation

Setup · Other setups · Admin · PWA · App shell · Technical details · Contributing · AGENTS.md

License

PolyForm Noncommercial 1.0.0 · Security · Code of Conduct

_{Credits. Design inspiration: the interface is inspired by the WHOOP app's look and flow. Pulse is a free, non-commercial community project by an independent developer. It is not affiliated with, endorsed by or competing with WHOOP, Inc., uses no WHOOP device, data, code or assets, and every score is computed from your own Google Health data. WHOOP is a trademark of WHOOP, Inc. If you represent WHOOP or any other company and have a concern, please email work.adityajindal@gmail.com and it will be changed or taken down.

noop: the recovery, strain, sleep and readiness scoring is ported from its analytics engine.

Hælan: its notes on how the Google Health API behaves saved a lot of trial and error.}