README.md

metadata

title: Grabette Fleet
emoji: 🌍
colorFrom: yellow
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
hf_oauth: true
hf_oauth_expiration_minutes: 480

Grabette fleet — operator dashboard + command broker

A Docker HuggingFace Space (runs fine on the free CPU tier). It is the operator dashboard and an in-memory command broker for one user's fleet.

operator (this Space, HF login) ──queue command──▶ in-memory broker ◀──short-poll── device (Pi)
                                ◀──device status──                   (Bearer hf_token)
device captured data ──────────────────────────────────────────────▶ HF dataset (durable)

• Operator signs in with HuggingFace (native Space OAuth) and controls only their own devices.
• Devices connect outbound with Authorization: Bearer <hf_token>; the Space resolves the owner via whoami and groups devices by HF identity.
• Transport is short-polling — which also keeps the free Space awake (sleep is timed from the last request).

State is in-memory: a restart drops it and devices re-register on their next poll. Durable data (device history, captured datasets) lives in HF datasets, not here.

Duplicate for your own fleet

One Space = one owner = one fleet. Click ⋮ → Duplicate this Space to run your own — hf_oauth is auto-provisioned, so there's nothing to configure. Then point your devices at it with GRABETTE_RELAY_URL=https://<you>-grabette-fleet.hf.space.

Devices are run with device_app.py from the grabette_connector project.