Documentation

Everything you need to integrate human physiological context into your AI applications.

Getting Started

Quickstart Guide

Key → session → first call in 30 seconds

API Reference

Endpoints, auth, rate limits, error codes

POST /v1/ingest

Full field reference with types and ranges

Core Concepts

State Mapping

Calm → Acute Stress (0-100)

Architecture

Edge-first, hardware-agnostic design

Privacy

Edge processing, auto-delete, GDPR

Regulatory

General Wellness, not a medical device

Products

Cognitive Compute Router (Gateway)

3 modes, 11 LLM providers, zero code changes

MCP Server

6 tools for Claude, Cursor, Windsurf, and 15+ AI agents

A2A Server

4 skills for agent-to-agent collaboration (JSON-RPC 2.0)

CLI

Official command line tool: @nefesh/cli

Human State Protocol

Open specification for exchanging human state between AI systems

Webhooks

State change notifications

Signal Categories

Cardiovascular

HR, HRV, SpO2

Vocal

Tone, speech rate, pitch

Visual

Expression, gaze, posture

Textual

Sentiment, urgency

EDA

Skin conductance

Respiratory

Breathing rate

Metabolic

CGM glucose

Neural

EEG bands

Movement

Activity, steps

Sleep

Sleep stages

Integrations

Nefesh works with any device.

The universal /v1/ingest endpoint accepts biometric signals from any hardware that can make an HTTP POST, in real time. The integrations below are popular examples, not a closed set.

See the universal integration guide →

Polar H10

Web Bluetooth chest strap

Garmin

Connect IQ smartwatch

Pixel Watch

Health Connect (Android)

Apple Watch

HealthKit (iOS)

Webcam rPPG

Contactless HR via camera

✦ Any Device

Universal integration guide

Use Cases

AI Coaching

Adaptive guidance

Telehealth

Patient monitoring

Education

Cognitive load tutoring

Digital Avatars

Responsive companions

Accessibility

Adaptive interfaces