Skip to content

About

A privacy-first, subscription-free health tracker for affordable wearables.

Topics

Resources

Code of conduct

Contributing

Stars

336 stars

Watchers

6 watching

Forks

Latest commit

Β 

History

444 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PulseLoop

Stars Forks Issues PRs CI Platform Swift License Docs Discord

PulseLoop

πŸ“š Documentation Β· πŸ“± Now on Android Β· πŸ’¬ Join the Discord Β· πŸ“– Read the writeup

Featured on communities:

r/ReverseEngineering r/hardwarehacking r/selfhosted r/degoogle X post

PulseLoop is a native iOS health tracker for affordable Bluetooth smart rings, with an optional AI Coach. It supports jring, Colmi / Yawell (QRing and SmartHealth), R10M / LittleMeatball, and experimental TK5, LuckRing / TK18, RWfit, and Colmi R11 / Da Rings integrations. See the supported rings and validation status before pairing.

PulseLoop talks to the ring directly over Bluetooth LE (no vendor cloud, no account) and layers an optional AI Coach on top of your own data. Instead of static charts, you get a coach that can read your metrics, run its own analysis, draw charts, remember context about you, and answer questions about your sleep, heart rate, activity, and recovery.

Goal: prove that a $20 ring + an LLM can replace a $300 subscription wearable, and that the "intelligence" should live on the phone, not behind a paywall.

Documentation

πŸ“š Full docs: saksham2001.github.io/PulseLoopiOS

What it does

  • Connects to the ring over BLE and decodes its proprietary protocol (heart rate, SpOβ‚‚, steps, distance, calories, sleep stages, raw packets).
  • Today / Vitals / Sleep / Activity dashboards built natively in SwiftUI, backed by SwiftData for local persistence.
  • AI Coach β€” an agentic loop (OpenAI, Google Gemini, OpenRouter, MiniMax, Apple's on-device Foundation Models, or any OpenAI-compatible server you run yourself β€” Ollama, llama.cpp, vLLM, SGLang, LM Studio) with tools for data retrieval, on-the-fly analysis, chart generation, and long-term memory. Image input and web search depend on the provider and model. Optional AI actions can update goals and log meals or workouts. See the local-model setup guide to use a server you control.
  • Workout recording with live heart-rate zones, GPS route maps, a Live Activity, and a Dynamic Island widget.
  • Nutrition tracking with meal logging, barcode scanning, calorie and macro goals, and optional AI meal analysis.
  • Apple Health export for supported ring metrics and workouts, with per-type controls and an optional history backfill.
  • Strava workout uploads, manually or automatically after a workout, in builds configured with Strava API credentials.
  • Home Screen widgets for daily activity and configurable metric tiles.
  • Daily check-in notifications generated by the coach from your recent trends.

πŸ“š Diagrams and a full walkthrough: Architecture docs.

Screenshots

Today AI Coach Sleep
Today Coach Sleep
Activity Vitals Workout Summary
Activity Vitals Workout Summary

Also on Android

PulseLoop has a sister project for Android: PulseLoopAndroid

The two ports share BLE protocol research and coordinate fixes and new ring support. Features and hardware validation can differ between platforms; see the iOS vs Android comparison and each project's compatibility notes before choosing a build.

Coordination, the shared roadmap, and cross-platform discussion all happen in the Discord.

Community

We run a Discord for roadmap planning, getting-started help, and coordinating the iOS + Android efforts. It's the fastest place to get unstuck, claim an issue, or propose a feature.

πŸ‘‰ Join the PulseLoop Discord

New here? Good places to start:

Supported Wearables

Disclaimer: We have no affiliation with the sellers or manufacturers of any of the wearables listed below. We do not endorse them and take no responsibility for their quality, accuracy, performance, durability, data security, or anything else that might go wrong with them. Listings are provided for convenience only β€” links may break, sellers may swap hardware under the same name, change prices, and your unit may behave differently from mine. Buy at your own risk and treat any data the ring produces as approximate.

PulseLoop has eight driver families. The pairing catalog includes the models below; a supported family does not mean every rebranded unit has been tested. The app shows features according to the connected ring's capabilities.

Ring / firmware Models in the pairing catalog Protocol iOS support
jring Generic SMART_RING / 56ff ring Custom 56ff Supported
Colmi / Yawell β€” QRing Colmi R02, R03, R06, R07, R08, R09, R10, R11, R12, Ring 2 Pro; Yawell R05, R10, R11; H59 QRing UART (6e40fff0 / de5bf728) Supported; sensor features vary by model
Colmi / Yawell β€” SmartHealth Colmi R99 defaults to SmartHealth; the other Colmi / Yawell / H59 cards also offer this firmware option Yucheng YCBT (be940) Supported; verified on an R99, with per-unit capability detection
R10M / LittleMeatball R10M Yucheng YCBT (be940) Supported; validated end to end on firmware 2.32
TK5 TK5 Yucheng YCBT (be940) Limited β€” driver implemented; TK5 hardware validation pending
LuckRing TK18; family matching also accepts LuckRing-app siblings, including some SIMSONLAB / Yoidesu rebrands K6 (F618, manufacturer ID 0xFF64) Limited β€” TK18 tested; sibling models and some sensor readings remain unverified
RWfit RWfit ring (generic card; SR16 / SY01 validation pending) A00A, legacy 0x7E / modern 0xAB Limited β€” SDK-derived implementation; successful hardware validation pending
Colmi R11 β€” Da Rings Colmi R11 (Da Rings app) CRP / Moyoung (FDDA) Limited β€” some sleep and vital packets confirmed; full validation pending

Choose the app your ring shipped with. Colmi branding and Bluetooth names alone do not identify its firmware. For QRing or SmartHealth units, select the matching app during pairing; PulseLoop offers a retry with the other app if connection fails. The Da Rings R11 uses a separate protocol: select β€œColmi R11 (Da Rings app)”, even if Bluetooth calls it SMART_RING. RWfit-app rings likewise use their own driver, including units sold under the Colmi name.

The Ring 2 Pro has model-specific support for on-demand HRV, stress, and skin temperature. Those features are not promised for every QRing model.

Not supported: Oura, Ultrahuman, RingConn, and the SIMSONLAB LA380-YJ. A SIMSONLAB-branded ring sold for the LuckRing app is a different device family.

πŸ“š Protocol details, capabilities, and known limitations: Supported hardware docs.

Install & try it

πŸ“² TestFlight beta

The public TestFlight beta is live. Sign up here to request an invite, or ask on the Discord.

πŸ“¦ Sideload an IPA

Download an unsigned IPA from the GitHub releases and sign it with your own Apple account or certificate. See the sideloading guide for signing options and App Group requirements for widgets.

πŸ› οΈ Build from source (Xcode)

Use Xcode 26+ and an iOS 18+ device for Bluetooth ring testing. Open PulseLoop.xcodeproj, select the PulseLoop scheme, and configure your Team, unique Bundle Identifiers, and matching App Group for the app and both extensions (PulseLoopLiveActivityExtension and PulseLoopWidgetsExtension). Then build and run on your device.

A ring and an API key are optional for exploring the app: load demo data from Settings β†’ Reseed demo data. For the Coach, choose a hosted provider with your own key, an Apple on-device model on an eligible iPhone running iOS 26+, or a local / self-hosted server.

πŸ“š Full step-by-step build, signing, and demo-data instructions: Getting started β€” iOS. Building on Android? See the Android guide.

Contributing

PRs and issues are very welcome β€” this project moves fast because people pitch in. Before you start:

  1. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md.
  2. Open or comment on an issue so we don't duplicate work.
  3. CI runs automatically on every PR (build + SwiftLint): keep it green!
  4. Coordinate bigger changes in the Discord, especially anything that should land on Android too.

Adding a new ring? Start with the family and capability contracts in PulseLoop/Wearables/, the drivers in PulseLoop/RingProtocol/, and the pairing catalog in WearableModel.swift. Device reports with firmware versions and opt-in raw-packet diagnostics help validate the limited-support drivers.

πŸ“š The roadmap and architecture / project layout now live in the docs.

Acknowledgements

Contributors

Thanks to everyone who's contributed to the iOS app πŸ’œ

@saksham2001
@saksham2001
@rgvxsthi
@rgvxsthi
@hoveeman
@hoveeman
@radxp
@radxp

The contributors graph tracks code contributions. Thanks also to everyone who files issues, tests rings, and shares device reports.

License

This project is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).

You're free to share and adapt the work, including commercially, as long as you give appropriate credit. Please attribute:

PulseLoop by Saksham Bhutani β€” https://github.com/saksham2001/PulseLoopiOS

About

A privacy-first, subscription-free health tracker for affordable wearables.

Topics

Resources

Code of conduct

Contributing

Stars

336 stars

Watchers

6 watching

Forks

Releases

Packages

Contributors

Languages