Recovery, strain and sleep from your Google Health data.
Pulse turns what your Fitbit or Pixel Watch syncs to Google Health into daily scores, on a server you own or right on your Android phone. Built on Fitbit Air. Free.
The Android app needs no server or account: it scores your Fitbit data on the phone, from Health Connect. Pulse Mobile on GitHub
Keep strain light
Your body needs rest today. Keep strain between 4.0 and 6.0.
Time to recover
Your HRV is below your baseline, which held Recovery back today.
Last night’s sleep
Your sleep was sufficient. You slept 87 minutes less than you needed; an earlier night helps.
Skin temperature is outside your usual range. This can be an early sign of illness or heavy strain.
View Health MonitorKeep strain light
Your body needs rest today. Keep strain between 4.0 and 6.0.
Time to recover
Your HRV is below your baseline, which held Recovery back today.
Last night’s sleep
Your sleep was sufficient. You slept 87 minutes less than you needed; an earlier night helps.
Skin temperature is outside your usual range. This can be an early sign of illness or heavy strain.
View Health MonitorThree numbers each morning.
Sleep, Recovery and Strain open the app, each scored against your own baselines.
Everything your wearable records, made useful.
Every card below is the app itself, running on generated demo data.
Pulse Age
How old your body is behaving, and whether that is speeding up or slowing down.
Recovery, explained
HRV, resting heart rate, breathing and sleep, each against your last 30 days.
Strain Target
A range for today, set by how recovered you are.
Stress Monitor
Your stress through the day, on a 0 to 3 scale.
Journal
Log water, food, weight and mood, synced both ways with Google Health, answer the questions you pick from fifty behaviours, and see what moves tomorrow’s Recovery.
Health Monitor
Last night’s vitals against your normal range, with ECG readings and irregular rhythm notifications below.
Trends
Any metric by week, month, six months or year.
Reports
A weekly and monthly read of how it went.
Also in Pulse
- Energy Bank
- Sleep planner
- Training load
- Illness watch
- Live heart rate
- Fitness level
- Push notifications
- Works offline
- Export everything
- Food and water log
Ask about your own numbers.
The P button opens Coach. Ask for today’s brief, explore what changed, or plan training and tonight’s sleep with your own data.
- Your key, your provider
- Anthropic, OpenAI, Gemini, Vercel AI Gateway, OpenRouter, or a model on your own server. The key is encrypted and never reaches the browser.
- Logs only when you tap
- It looks up sleep, workouts, trends and habits, with evidence cards that link back to your data. Ask it to log water or a meal and it shows the entry first; nothing is saved until you tap Log.
- Advice for your day
- Suggestions adapt to your Recovery, sleep, HRV and accumulated strain, and each workout gets a one-line take. Older turns are summarized so longer chats keep their context.
- Off until you turn it on
- Admins choose who gets the coach. Without it, the same button opens the evening check-in.
On a laptop, the whole picture at once.
My Dashboard
Pick the metrics on Home, from Recovery and sleep consistency to weekly heart-rate zones and lean body mass, and drag them into the order you want.
Health
Stress, Pulse Age and its pace, the Health Monitor, fitness and heart rate on one screen, so a change in one is easy to check against the rest.
Health Monitor
Last night’s five vitals against your normal range, with ECG readings and body measurements beside them.
Trends
Any metric by week, month, six months or year, with the averages to compare against.
Scored and stored on a machine you control.
- Your wearableA Fitbit or Pixel Watch records heart rate, sleep and nightly vitals.
- Google HealthHolds your wearable’s data in your Google account.
- Health APIRead with an OAuth client from your own Google Cloud project.
- Your serverScores every day and keeps the history in Postgres, in Docker.
- Your phoneInstall it from the browser, like an app.
- Invite only
- Admins invite people. Each person connects their own Google account and sees only their own data.
- No tracking in the app
- It talks to Google’s Health API, and to an AI provider only if you turn the coach on.
- Leave whenever you like
- Export your data any time, or delete your account and everything in it.
17 scores, each explained in full.
Inputs, weights, bands, limits and sources for every number Pulse shows.
- RecoveryHow ready your body is to take on strain today, from 0 to 100%.
- StrainThe cardiovascular load of your day, on a scale from 0 to 21.
- Strain TargetA Strain range for today, set by your Recovery and recent load.
- Sleep PerformanceHow well last night’s sleep met your need, from 0 to 100%.
- Sleep PlannerTonight’s sleep need, and the bedtimes that meet it.
- Pulse AgeHow old your body behaves, and how fast that is changing.
- Stress MonitorHow far your heart rate sits above your calm level, from 0 to 3.
- Energy BankAn estimate of how much energy you have left today, 0 to 100%.
- Health MonitorLast night’s five vitals against your own normal ranges.
- Fitness levelYour VO2 max compared with people of your age and sex.
- Training balanceWhether your recent strain is above or below what you are used to.
- Behaviour insightsHow each behaviour you log goes with your next day’s scores.
- Sleep consistencyHow closely your sleep and wake times repeat from day to day.
- Fitness, fatigue and formYour long-term and short-term training load, and the gap between them.
- Heart rate recoveryHow far your heart rate drops in the minute after a workout.
- Heart rate variability (HRV)The night-to-night signal Recovery leans on most, read from your Google Health data.
- Resting heart rateYour lowest sleeping heart rate, and the vital most scores lean on.
Try the demo in five commands.
No Google account needed for the demo. Connecting your own data takes a Google Cloud OAuth client and an HTTPS address; the setup guide walks through both.
$ 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 devOpen localhost:3000 and choose Continue with demo data.
# .env: Google OAuth client, BETTER_AUTH_SECRET, ADMIN_EMAILS
$ docker compose up -d --build
$ docker compose logs -f pulsePut a tunnel or HTTPS reverse proxy in front, create your account, then invite people from /admin.
Questions
Something else? Ask on GitHub.
Is Pulse free?
Yes, for personal and other noncommercial use, under the PolyForm Noncommercial 1.0.0 license. Selling it, or putting it inside a commercial product, is not allowed.
What do I need to run it?
A wearable that syncs to the Google Health app (Pulse is built and tested on the Fitbit Air), a Google Cloud project for the OAuth client, and any machine that runs Docker: a home server, a NAS or a small cloud VM. To reach it from your phone, give it an HTTPS address with a tunnel or reverse proxy. The setup guide covers each step.
Is there an Android app that needs no server?
Yes: Pulse Mobile, a separate Android app. It reads your Fitbit data from Health Connect and scores and stores it on the phone, with no server, no Google Cloud project and no account. It imports what Health Connect holds, up to the last 180 days, and does not share a Pulse server’s history. Download the APK.
Can I try it before connecting my Google account?
Yes. Demo mode generates 180 days of realistic data on your laptop, with no Google account and nothing sent anywhere.
Where does my data go?
From Google Health to your own server. The app talks to Google’s sign-in and Health API, and to an AI provider only if you turn the coach on with your own key. There is no Pulse cloud and no analytics in the app.
Can several people share one Pulse?
Yes. Sign-up is invite-only by default: the server’s admins invite people, each person connects their own Google account, and nobody can see anyone else’s data.
Does the AI coach cost anything?
Pulse charges nothing. The coach uses your own API key with Anthropic, OpenAI, Google Gemini, Vercel AI Gateway or OpenRouter, so that provider bills you for what you use. A server owner can also point it at a local model.
Does it work with a Pixel Watch or other Fitbits?
Pulse reads the Google Health API, which carries the same kinds of data from every device that syncs to the Google Health app, Pixel Watch and other Fitbits included. It is built and tested with the Fitbit Air, so treat other devices as untested: the scores are tuned to what the Air records, and a device that lacks a signal, such as overnight HRV, gets fewer scores.
The old Fitbit Web API is shutting down. Does that affect Pulse?
No. Pulse uses the newer Google Health API from the start, with your own Google OAuth client.
Are the scores medical advice?
No. Pulse is a wellness tool, not a medical device. Every score is an estimate from a wrist sensor, and each metric page lists its limits.
Made by one developer, for the community.
There is no company behind Pulse, and no intention of competing with WHOOP or anyone else. It uses no WHOOP device, data, code or assets: every score is computed from your own Google Health data, with methods published in full. The interface takes design inspiration from apps the developer admires.
WHOOP and the other names on this site are trademarks of their owners, and Pulse is not affiliated with or endorsed by them. If you represent a company and have a concern, please email work.adityajindal@gmail.com and it will be changed or taken down.
Credits
Recovery, strain and sleep scoring is ported from noop. Hælan’s notes on the Google Health API saved a lot of trial and error.
Weighing it up?
- Does the Fitbit Air have strain and recovery scores?
- Pulse and subscription recovery wearables, compared
- Recovery and strain tracking without a subscription
- Google Health Premium, WHOOP and Pulse: what each adds
- Fitbit Air vs Garmin Cirqa: the scores compared
- Fitbit Air vs Amazfit Helio Strap: the scores compared
- Fitbit Air vs Oura Ring: sleep and readiness
- Google Health app vs Garmin Connect, as dashboards
- Pixel Watch vs WHOOP: scores, cost and data
- How each brand builds its recovery or readiness score
See what your Google Health data already knows.
Free for personal use. Your server or your phone, your data.