Hardware Unification Protocol

Bring your own device.

HUP is the public wire contract between a FERAL brain and any piece of hardware. If your device can terminate TLS and speak JSON over WebSocket, it can plug in — no proprietary glue.

Version

HUP v1.0.0

License

Apache-2.0

SDKs

Python + TypeScript

How a device daemon joins

1. Daemon opens a WebSocket to wss://<brain>:<port>/v1/node.
2. Sends node_register with its node_id, capabilities, sensors, actuators, firmware version.
3. Brain returns node_ack with the session token + granted capabilities.
4. Daemon emits device_event frames (sensor data) and responds to hup_action_request frames (actuator triggers).

Ship a daemon in under an hour

The cookiecutter template gives you a runnable skeleton with mocks so you can focus on the hardware integration, not the wire protocol.

pip install cookiecutter feral-node-sdk
cookiecutter <redacted>.git \
    --directory feral-nodes/templates/hardware-daemon

cd my-new-daemon
feral publish --daemon .   # ships to registry.feral.sh

Template opens to early testers soon — follow @FeralAi67724 for the drop.

Python SDK

pip install feral-node-sdk

Opens to early testers soon — follow @FeralAi67724

TypeScript SDK

npm install @feral-ai/node-sdk

Opens to early testers soon — follow @FeralAi67724

Full HUP Spec

All frame schemas, error codes, pairing flow

Opens to early testers soon — follow @FeralAi67724

Daemon Template

Cookiecutter skeleton

Opens to early testers soon — follow @FeralAi67724

First-party daemons

Reference implementations from the FERAL team that ship in the registry as verified, featured items:

Wristband daemon — BLE biometrics (heart rate, HRV, SpO2, skin temp) streamed as device_event frames.
W300 daemon — Smart glasses: camera frames, mic, GPS, IMU.
HomeKit / Matter bridge — Any HomeKit- or Matter-compatible accessory exposed as actuators (lights, thermostats, plugs).

Security report? Stable API question? Reach us on @FeralAi67724 — repo + issue tracker open to early testers soon.