NeccessoryNeccessory

Welcome

neccessory — camera-based wellness vitals for iOS, the web, and a REST API.

neccessory turns an ordinary front-facing camera into a contactless wellness vitals sensor. Point the camera at a face and it estimates heart rate, heart-rate variability, breathing rate, and a stress index — plus experimental blood pressure and blood-oxygen (SpO2) estimates — for general wellness use.

neccessory comes in two tiers, and they differ in exactly one respect — where the analysis runs:

  • On-device. The whole pipeline runs on the phone or in the browser. Raw camera frames are never uploaded; only the finished result leaves, and only if you submit it. Available by application.
  • Cloud. The client sends cropped images of the face to our servers and the metrics are computed there. Frames are held in memory for the duration of the session and are never stored — but they are transmitted. Self-serve, and the result comes back attested.

Both tiers return the same measurement result. See the cloud overview for the full comparison, and cloud privacy for what transmitting face crops means in practice.

Wellness use only — not a medical device

neccessory provides camera-based estimates of physiological signals for general wellness and informational purposes only. It is not a medical device and is not intended to diagnose, treat, cure, or prevent any disease or health condition. Blood pressure and SpO2 are experimental estimates and must not be used for medical decisions. See the full disclaimer.

Start here

What you can measure

MetricTierUnit
Heart rateCorebpm
HRV — SDNN, RMSSD, pNN50Corems / %
Breathing rateCorebrpm
Stress indexCore0–100 index + level
Blood pressureAdvanced (Beta)mmHg
SpO2 (blood oxygen)Advanced (Beta)%

Core metrics are the reliable, headline outputs. Advanced (Beta) metrics (blood pressure, SpO2) are experimental estimates for wellness only — see Metrics and the disclaimer.

Every result also carries a required signal-quality level (good / fair / poor) so you always know how much to trust it.

The path from zero to a measurement

  1. Create an account at console.neccessory.com and create one key (a key id + secret) — see Getting Started and Obtaining Keys. New keys are cloud keys; on-device keys are granted by application.
  2. Add an SDK to your project — Web or iOS.
  3. Start a measurement and read the result — Cloud quickstart · Web quickstart · iOS quickstart.
  4. On-device only: submit completed measurements through the REST API. Cloud measurements are already stored when you receive them.