SENSE SDK
Know what a machine can do right now, and why.
Sense turns raw physical-machine telemetry into validated, normalized, explainable current-capability context while preserving evidence quality and freshness.
From machine state to physical context
Sense validates raw telemetry, normalizes units and field names, applies freshness rules, and evaluates versioned capability definitions. Results use four states: available, degraded, unavailable, or unknown.
Unknown is a deliberate safety property. Missing, stale, invalid, or failed evidence is not silently interpreted as a concrete physical failure or a valid capability.
Evidence, explanations, and privacy
Capability results retain structured reasons, including nested outcomes for composed rules. Separate observation and receipt times make freshness explicit, while transitions show how machine capability changed.
Snapshots are language-neutral and versioned. Their publishable view excludes raw observations by default; an integrator must explicitly allow any telemetry that should be shared.
Developer integration
Sense is a local-first Python SDK supporting Python 3.10 and newer. It can ingest replay or simulator data and offers optional ROS 2, MQTT, HTTP, and peaq integration packages.
The official peaq path can publish capability transitions as Activity Events and integrate with Machine Markets. Wallet custody remains with the official peaqOS client; Sense does not accept private keys as CLI arguments.
Supported and experimental boundaries
The repository identifies Sense 0.3.0-dev as an open-source developer preview. The API is usable, but packages are not yet on PyPI and remain pre-1.0 while adapters and ecosystem integration mature.
Sense is not a robot controller, planner, safety-certification system, world model, fleet manager, machine identity system, or replacement for ROS 2 or peaqOS.
Common questions
What does Sense do?
Sense turns machine telemetry into validated, normalized, explainable context about the capabilities a machine has right now.
How does Sense handle missing or stale data?
Missing, stale, invalid, or failed evidence produces an unknown result rather than a guessed capability state.
Is Sense a robot controller?
No. Sense evaluates and explains current capability context; it does not plan motion, control a robot, or certify safety.