npm install @agentium/edge

import { Agent, ollama } from "@agentium/core";
import {
  SystemToolkit,
  GpioToolkit,
  EdgeRuntime,
  edgePreset,
  ensureOllama,
  registerEdgeToolkits,
} from "@agentium/edge";

// Register edge toolkits in the catalog (for Admin UI)
registerEdgeToolkits();

// Ensure Ollama is running
await ensureOllama();

const preset = edgePreset("pi5-8gb");

const system = new SystemToolkit();
const gpio = new GpioToolkit({ chipNumber: 4, allowedPins: [17, 27, 22] });

const agent = new Agent({
  name: "pi-agent",
  model: ollama(preset.recommendedModel),
  instructions: "You control a Raspberry Pi. Monitor system health and control GPIO pins.",
  tools: [...system.getTools(), ...gpio.getTools()],
});

const runtime = new EdgeRuntime({ preset, agent });
await runtime.start();

const result = await agent.run("What is the CPU temperature and memory usage?");
console.log(result.finalOutput);

@agentium/edge
├── Toolkits
│   ├── SystemToolkit     — CPU, memory, disk, network (zero deps)
│   ├── GpioToolkit       — GPIO read/write/watch/PWM
│   ├── CameraToolkit     — libcamera capture/record/stream
│   ├── SensorToolkit     — I2C sensors (BME280, BMP180)
│   ├── BleToolkit        — Bluetooth Low Energy
│   └── ServoToolkit      — Hobby servo control
├── Runtime
│   ├── EdgeRuntime       — Watchdog, resource monitor, health endpoint
│   ├── edgePreset()      — Device-specific configuration
│   └── Ollama helpers    — ensureOllama, pullModel, recommendModel
└── Sync
    └── EdgeCloudSync     — Heartbeat, config pull, offline queue

# GPIO (Pi 5 compatible)
npm install node-libgpiod

# I2C sensors
npm install i2c-bus

# Bluetooth BLE
npm install @stoprocent/noble