← Back to Docs

Architecture

Design Principles

  • Edge-first processing — raw sensor data stays on the device. Only extracted metrics reach the API.
  • Hardware-agnostic — one endpoint handles any sensor, any device, any signal type.
  • Server-side validation — strict schema, string limits, timestamp bifurcation.
  • Encrypted sessions — session data is isolated and auto-expires.

Signal Flow

Device → /v1/ingest → Validate → Categorize → Fuse → State → LLM

Infrastructure

  • api.nefesh.ai — REST API (FastAPI)
  • mcp.nefesh.ai — MCP Protocol server (Streamable HTTP)
  • nefesh.ai — Marketing + Documentation + Agent Discovery