SeaClip Documentation

Hub-Spoke AI Agent Orchestration for On-Prem Edge Mesh

Welcome! SeaClip is a self-hosted AI agent orchestration platform built for privacy-first, on-premises deployments. It connects a central hub to edge devices (Raspberry Pi, Jetson, phones, laptops) and coordinates AI agents running locally.

What is SeaClip?

SeaClip is a hardened fork of Paperclip AI, re-architected for the SpaceClaw / SeaClaw edge-mesh use case. Every compute node and every model run stays within your network.

🌐

Edge Mesh Dashboard

Real-time visibility into all spoke devices — status, telemetry, resource usage

🦙

Ollama Integration

Route tasks to local models (llama3, mistral, gemma2) with GPU tracking

🤖

Agent Zero Support

Deep integration with Agent Zero sessions, memory sync, and tool calls

📱

Telegram Bridge

Bot-based command interface and push notifications

🔗

Multi-Hub Federation

Link multiple SeaClip hubs for cross-site task routing

💰

Budget Control

Per-agent cost tracking with configurable spending limits

Architecture Overview

┌─────────────────────────────────────────┐
│  React Dashboard (Vite)                  │
│  Edge Mesh · Agents · Issues · Costs     │
├─────────────────────────────────────────┤
│  Express.js REST API + WebSocket         │
│  Routes · Services · Adapters            │
├─────────────────────────────────────────┤
│  PostgreSQL (Drizzle ORM)                │
│  Companies · Agents · Issues · Devices   │
├─────────────────────────────────────────┤
│  Adapters                                │
│  SeaClaw · Ollama · Agent Zero           │
│  Telegram · Process · HTTP               │
└─────────────────────────────────────────┘
       │              │              │
   ┌───┴───┐    ┌────┴────┐   ┌────┴────┐
   │  Pi   │    │ Jetson  │   │  Phone  │
   │ Spoke │    │  Spoke  │   │  Spoke  │
   └───────┘    └─────────┘   └─────────┘

The hub is the central server — it holds state, runs the dashboard, and dispatches tasks.
Each spoke is an edge device that runs agents, sending heartbeats and telemetry back to the hub.

Quick Start

One-Line Install (Hub)

bash 
curl -sSL https://raw.githubusercontent.com/t4tarzan/seaclip/main/scripts/install.sh | bash

Manual Install

bash 
git clone https://github.com/t4tarzan/seaclip.git
cd seaclip
pnpm install
pnpm dev

See the Hub Installation Guide for detailed instructions.

Editions

Edition Description
v1-simple Base SeaClip — edge mesh, Ollama, Agent Zero, Telegram, hub federation. Minimal dependencies.
v2-enhanced Full feature set — adds BMAD profiles (9 agents), Grammar Shield, Pixel Office, GMeet UI, Git-Agent workflow.

Next Steps

1

Understand the Architecture

Learn how hubs, spokes, and adapters work together

 2

Install the Hub

Set up your central SeaClip server

 3

Connect Edge Devices

Register Raspberry Pi, Jetson, or other spokes

 4

Test Connectivity

Verify communication between hub and spokes