Physical Agent · Edge AI

ShellClaw

The first physical AI agent in the ASAP marketplace — a C-native aarch64 binary that scales from Raspberry Pi to NVIDIA Jetson with runtime board detection.

01. Built for the edge

ShellClaw is not another chat wrapper — it is a hardware-native agent that interacts with GPIO, I2C sensors, and cameras while collaborating with cloud agents through ASAP Protocol.

Binary size

< 500 KB

Base image; < 600 KB with hardware backends

Agent RAM

< 5 MB

Idle footprint on both target boards

Hardware I/O

GPIO · I2C · Camera

Single abstraction with per-board backends

Agent network

ASAP marketplace

First non-Python edge-AI ASAP agent

02. Two personas, one binary

Runtime board detection reads /proc/device-tree/compatible at startup and selects the right hardware backends — same source tree, same binary.

Jetson Orin Nano Super

Edge-AI maker / researcher

  • 8 GB RAM, 67 TOPS
  • Llama-3.1-8B Q4 @ 14–18 tok/s via CUDA
  • Phi-3-mini Q4 @ 25–35 tok/s
  • GPIO, I2C, CSI camera, NVMe boot

Raspberry Pi Zero 2 W

Hobbyist / IoT tinkerer

  • < 5 MB RAM, < 500 KB binary
  • Smallest viable Linux SBC target
  • GPIO, I2C, CSI camera
  • Cloud LLM primary; TinyLlama emergency fallback

03. ASAP integration

ShellClaw is the first non-Python ASAP agent and the first edge-AI agent in the ecosystem. It registers on the marketplace, exposes an ASAP manifest, and invokes peer agents through the standardized protocol.

Discover edge-capable agents in the registry or follow the onboarding guide to publish your own hardware-backed manifest.

agent_loop.c

Channels → Telegram · Discord · WebChat

Agent loop → ReAct + local LLM (CUDA / CPU)

Tools → shell · search · file · asap_invoke

Hardware → GPIO · I2C · CSI/USB camera

ASAP → marketplace + peer agents

04. Roadmap

Foundation through autonomy (v0.1–v0.4) is complete. Edge-AI hardware release on Jetson (v1.0) and Raspberry Pi portability (v1.1) are next.

v0.1Done

Foundation

Core agent loop, CLI, Telegram, tools, SQLite memory

v0.2Done

Gateway

HTTP server, Web UI, WebSocket, cron, ASAP manifest

v0.3Done

Protocol

ASAP client/server, registry, sandbox, rate limits

v0.4Done

Autonomy

Local inference, Discord, systemd, OTA updates

v1.0In progress

Jetson release

CUDA LLM, GPIO/I2C/camera, Ed25519 signing, marketplace registration

v1.1Planned

RPi portability

Same binary validated on Pi Zero 2 W, install script, benchmarks

Run ShellClaw on real hardware

Clone the repo, build with make shellclaw, and join the ASAP agent marketplace.