Edge Devices (Spokes)

Connect edge devices to your SeaClip hub for distributed AI agent execution

What is a Spoke? A spoke is any edge device that connects to your SeaClip hub. Spokes run AI agents locally, send telemetry to the hub, and receive task assignments. This keeps compute and data on-premises.

Supported Devices

🍓

Raspberry Pi

Pi 4/5 with 4GB+ RAM. Great for lightweight agents and sensor integration.

Setup Guide →
🎮

NVIDIA Jetson

Jetson Nano, Xavier, Orin. GPU-accelerated inference with Ollama.

Setup Guide →
🖥️

Generic Linux

Any x86_64 or ARM64 Linux machine. Ubuntu, Debian, Fedora, etc.

Setup Guide →
📱

Android (Termux)

Run agents on Android phones via Termux. Experimental.

Setup Guide →

One-Line Spoke Install

Run this on your edge device to connect it to your hub:

bash 
curl -sSL https://raw.githubusercontent.com/t4tarzan/seaclip/main/scripts/spoke-install.sh | bash -s -- --hub https://your-hub-ip:51842

Replace your-hub-ip with your hub's IP address or hostname.

What the Installer Does

  1. Installs dependencies

    Node.js, pnpm, and required system packages

  2. Downloads the spoke agent

    Lightweight agent runtime for edge devices

  3. Registers with the hub

    Sends device info and receives registration token

  4. Starts telemetry service

    Begins sending CPU, RAM, disk, and GPU metrics

  5. Installs as systemd service

    Auto-starts on boot

Manual Spoke Setup

Step 1: Install Prerequisites

bash — Debian/Ubuntu 
# Install Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install pnpm
npm install -g pnpm

# Install system tools
sudo apt-get install -y curl jq

Step 2: Download Spoke Agent

bash 
git clone https://github.com/t4tarzan/seaclip.git /opt/seaclip-spoke
cd /opt/seaclip-spoke
pnpm install --filter @seaclip/spoke

Step 3: Configure the Spoke

bash 
cat > /opt/seaclip-spoke/.env << EOF
SEACLIP_HUB_URL=https://your-hub-ip:51842
SEACLIP_DEVICE_NAME=$(hostname)
SEACLIP_DEVICE_TYPE=generic-linux
SEACLIP_TELEMETRY_INTERVAL=30
EOF

Step 4: Register with Hub

bash 
cd /opt/seaclip-spoke
pnpm spoke register
$ pnpm spoke register
Registering device with hub at https://192.168.1.100:51842...

Device registered successfully!
Device ID: dev_abc123
Device Name: pi-kitchen
Status: pending

Registration token saved to ~/.seaclip/device-token

Next: Start the spoke agent with 'pnpm spoke start'

Step 5: Start the Spoke Agent

bash 
pnpm spoke start

Step 6: Install as System Service

bash 
sudo cp /opt/seaclip-spoke/scripts/seaclip-spoke.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable seaclip-spoke
sudo systemctl start seaclip-spoke

Telemetry Data

Spokes send the following telemetry to the hub every 30 seconds:

Metric Description Unit
cpuPercent CPU utilization 0-100%
ramUsedGb RAM in use GB
ramTotalGb Total RAM GB
diskUsedGb Disk space used GB
diskTotalGb Total disk space GB
gpuPercent GPU utilization (if available) 0-100%
cpuTempC CPU temperature °C
uptimeSeconds Device uptime seconds

Device Status

The hub monitors device health and assigns status:

Status Health Score Description
online ≥ 80 Device is healthy and accepting tasks
degraded 50-79 High load or temperature, reduced capacity
unhealthy < 50 Critical issues, tasks may be reassigned
offline — No telemetry for 90+ seconds

Verify Connection

After setup, verify your spoke is connected:

On the Spoke

bash 
pnpm spoke status

On the Hub

bash 
pnpm cli device list

In the Dashboard

Navigate to Edge Mesh in the sidebar to see all connected devices.

Next Steps

→

Device Registration

Detailed registration and authentication flow

 →

Test Connectivity

Verify hub-spoke communication