Repolode
Submit
0xCodez

0xCodez/pulsr

Open-source iOS and watchOS app that turns Apple Watch health data into daily recovery, strain and sleep scores, computed on-device.

Open-source alternative to:WHOOPOura

View on GitHub
Stars
100
Forks
17
Open issues
0
Last commit
5 days ago

What is it?

Pulsr reads the heart rate, HRV, sleep stages, respiratory rate and workouts that an Apple Watch already records in Apple Health, and converts them into daily Recovery (0–100%), Strain (0–21) and Sleep scores. Recovery compares overnight HRV, resting heart rate, respiratory rate and sleep against the user's own 30-day baseline, and Strain is calculated from minute-by-minute heart rate using the Banister TRIMP method.

The app is built with SwiftUI for iOS 26 and includes a Watch app, Stress and Health monitors, a Journal that tracks how daily behaviors affect next-day recovery, and a Coach that answers questions about the data using Apple's on-device Foundation Models. HealthKit access is read-only, and there are no accounts, analytics or network calls.

Pulsr is not distributed through the App Store. Users build and install it from source with Xcode using a free or paid Apple ID, and the project includes a demo mode with synthetic data. It is a wellness project and not a medical device.

Key features

  • 01Daily Recovery, Strain and Sleep scores calculated from Apple Watch data
  • 02Recovery compared against the user's own 30-day baseline
  • 03Strain based on minute-by-minute heart rate using Banister TRIMP
  • 04Journal that shows how daily behaviors affect next-day recovery
  • 05Coach powered by Apple's on-device model, with no API key required
  • 06Read-only HealthKit access with all calculations done locally

Use cases

  • Tracking recovery and training load with an Apple Watch you already own
  • Checking how alcohol, caffeine or late nights affect next-day recovery
  • Exploring your own sleep and HRV trends without sending data to a third party
  • Learning how wearable recovery scores are calculated by reading the open-source code

Quick start

  1. 1

    Clone the repo

    git clone https://github.com/0xCodez/pulsr.git && cd pulsr
  2. 2

    Create your local signing config file

    cp Config/Local.xcconfig.example Config/Local.xcconfig
  3. 3

    Open Pulsr.xcodeproj in Xcode, select your iPhone, and press Run

  4. 4

    Enable Developer Mode on the iPhone and watch, then trust your developer certificate

Things to know

  • Not on the App Store, so you must build it yourself with Xcode on a Mac.
  • Requires Xcode 26+, iOS 26+ and watchOS 26+.
  • Apps signed with a free Apple ID expire after 7 days and must be re-run from Xcode.

In collections

Open-source Mac appsOpen-source personal AI agents

Topics

#apple-watch#healthkit#swiftui#hrv#fitness#sleep-tracking#watchos#personal-agent#ios#open-source

FAQ

What is pulsr?
Open-source iOS and watchOS app that turns Apple Watch health data into daily recovery, strain and sleep scores, computed on-device. Pulsr reads the heart rate, HRV, sleep stages, respiratory rate and workouts that an Apple Watch already records in Apple Health, and converts them into daily Recovery (0–100%), Strain (0–21) and Sleep scores. Recovery compares overnight HRV, resting heart rate, respiratory rate and sleep against the user's own 30-day baseline, and Strain is calculated from minute-by-minute heart rate using the Banister TRIMP method.
Is pulsr free to use? What license does it have?
pulsr is open source under the MIT license. Check the license terms before using it in commercial products.
Is pulsr still maintained?
Actively maintained. The last commit to pulsr was on Nov 2, 2026.
What can I use pulsr for?
Tracking recovery and training load with an Apple Watch you already own Checking how alcohol, caffeine or late nights affect next-day recovery Exploring your own sleep and HRV trends without sending data to a third party Learning how wearable recovery scores are calculated by reading the open-source code
How do I install pulsr?
Clone the repo: git clone https://github.com/0xCodez/pulsr.git && cd pulsr Create your local signing config file: cp Config/Local.xcconfig.example Config/Local.xcconfig Open Pulsr.xcodeproj in Xcode, select your iPhone, and press Run Enable Developer Mode on the iPhone and watch, then trust your developer certificate
Where can I get pulsr?
The source code and installation instructions are on GitHub: https://github.com/0xCodez/pulsr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects