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. 1. Daemon opens a WebSocket to wss://<brain>:<port>/v1/node.
  2. 2. Sends node_register with its node_id, capabilities, sensors, actuators, firmware version.
  3. 3. Brain returns node_ack with the session token + granted capabilities.
  4. 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 https://github.com/FERAL-AI/FERAL-AI.git \
    --directory feral-nodes/templates/hardware-daemon

cd my-new-daemon
feral publish --daemon .   # ships to registry.feral.sh
Template lives in the public monorepo. For release drops follow @FeralAi67724.

Python SDK

pip install feral-node-sdk

Open on GitHub

TypeScript SDK

npm install @feral-ai/node-sdk

Open on GitHub

Full HUP Spec

All frame schemas, error codes, pairing flow

Open on GitHub

Daemon Template

Cookiecutter skeleton

Open on GitHub

First-party daemons

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

Security report? Stable API question? Open an issue on GitHub or reach us on @FeralAi67724.