Welcome to the Aidlab SDK
Aidlab, Aidlab 2 and Aidmed One are worn on the chest, right where the heart and lungs are. From there they record a single-lead ECG, breathing from changes in chest impedance, movement of the whole torso and skin temperature. Aidlab 2 adds skin conductance (EDA) and location, and Aidmed One measures nasal airflow through a cannula for sleep studies.
The Aidlab SDK is how your app talks to these devices. It's available for Python, Android, Apple platforms, Flutter and Unity, and every platform runs the same native core, so a signal looks the same in a Python notebook as in an iPhone app.
What's inside
You pick the signals you need, and the SDK delivers samples as they are measured, each with its capture timestamp and in physical units: ECG in volts, breathing in ohms, acceleration in g, temperature in degrees Celsius. Alongside the raw waveforms, the device computes heart rate, RR intervals, respiration rate, steps, activity and body position, so you don't have to begin by writing your own R-peak detector. You won't be parsing Bluetooth packets either; the SDK handles the device protocol.
Your app doesn't have to stay connected. The device can keep recording into its own memory while it's worn, and the next time your app connects, it synchronizes everything recorded in the meantime. Stored samples keep their original timestamps, so you can merge them with live data.
Besides signals, you get events: when the device is put on or taken off, when the wearer double-presses the button to mark a moment, and which bodyweight exercises the SDK recognizes from motion.
Data goes straight from the device to your app. There's no Aidlab account to create and no internet connection involved, so you decide where the data ends up. To work with data people have already recorded in the Aidlab app, use the Web API, or let an AI assistant read your own data through MCP.
In this documentation, "Aidlab" also covers Aidlab 2 and Aidmed One unless a section says otherwise.
Get started
- Install the SDK for Python, Android, Apple platforms, Flutter or Unity.
- Connect to a device.
- Collect data.
What you can build
A few ideas to start from:
- A sleep tracker that records breathing, heart rate and body position overnight. On Aidlab 2, sleep stages come straight from the device.
- A breathing coach that draws the live breathing waveform and helps the user slow down.
- A workout app that recognizes push-ups, squats, burpees and other bodyweight exercises.
- A stress study that combines heart rate variability with skin conductance from Aidlab 2.
- A research protocol where participants wear the device away from the phone, and you synchronize and analyze ECG sampled at up to 1000 Hz afterwards.
- A horror game in Unity that raises the tension when the player's heart starts racing.