PulseLoop is an LLM-native iOS health tracker that transforms affordable Bluetooth smart rings into sophisticated, conversational health monitoring devices. It targets users seeking a privacy-first, subscription-free alternative to expensive wearables, offering advanced AI-driven insights directly on their phone. The project's core benefit is democratizing health intelligence by leveraging low-cost hardware and on-device processing.

How It Works

The app connects directly to supported Bluetooth LE smart rings, bypassing vendor clouds and accounts to decode proprietary sensor data. It utilizes native SwiftUI and SwiftData for local data persistence and visualization. A key innovation is the AI Coach, an agentic loop integrating with various LLM providers (including on-device models) and equipped with tools for data analysis, chart generation, long-term memory, and web search, grounding all responses in the user's actual health metrics.

Quick Start & Requirements

• Install: TestFlight beta (invite request required) or build from source using Xcode 16+.
• Prerequisites: Xcode 16+, iOS 18+ device, compatible ring (e.g., generic Chinese jring, Colmi/Yawell R0x/R1x/H59), optional API key for AI Coach.
• Docs: Full documentation, iOS Getting Started, Architecture.

Highlighted Details

• LLM-powered AI Coach with tools for data retrieval, analysis, charting, long-term memory, and web search, capable of processing image inputs.
• Device-agnostic driver layer simplifies adding support for new Bluetooth LE wearables.
• Privacy-focused architecture with direct Bluetooth LE connection, local data persistence via SwiftData, and no reliance on vendor clouds or user accounts.
• Workout tracking features include live heart-rate zones, GPS mapping, Live Activity, and Dynamic Island integration.
• Cross-platform development with a synchronized Android counterpart, sharing core BLE protocol logic.

Maintenance & Community

• Community coordination, roadmap planning, and support are primarily handled via a Discord server.
• Contribution guidelines are detailed in CONTRIBUTING.md and CODE_OF_CONDUCT.md.
• The project acknowledges the Android port developer, @foureight84, and relies on community contributions for device support and feature development.

Licensing & Compatibility

• Licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
• This license permits sharing and adaptation, including for commercial purposes, provided appropriate credit is given to the original author, PulseLoop by Saksham Bhutani.

Limitations & Caveats

Wearable data should be treated as approximate, and the project has no affiliation with hardware manufacturers. Support listings are provided for convenience, with potential for broken links or hardware variations.