🤖 Hardware Skills for AI Agents

Turn hardware devices into A2A-compliant agents. Your AI can now control robots, sensors, and IoT devices.

Supported Hardware

M5StickC Plus 2

Compact ESP32 device with display, IMU, battery.

import { createM5StickAgent } from '@qusd/hardware-skills/m5stick';

const agent = createM5StickAgent({
  m5stickUrl: 'http://192.168.0.146',
  port: 8000,
});

await agent.start();
// Agent discoverable at /.well-known/agent.json

Capabilities:

• get_sensors — IMU, battery, button state
• display_text — Show text on LCD
• play_tone — Play audio tones
• scan_wifi — Scan nearby networks
• set_led — Control LED

Waveshare UGV Robots

WAVE ROVER, UGV Rover, UGV Beast, RaspRover, UGV01/02.

import { createUGVAgent } from '@qusd/hardware-skills/waveshare';

const agent = createUGVAgent({
  ugvUrl: 'http://192.168.1.100:5000',
  port: 3010,
});

await agent.start();

Capabilities:

• move_robot — Motor control (-100 to 100)
• stop_robot — Emergency stop
• set_camera — Pan-tilt camera control
• get_sensors — Battery, ultrasonic, IMU
• capture_image — Camera snapshot

Installation

git clone https://github.com/QUSD-ai/hardware-skills
cd hardware-skills
bun install

Quick Start

M5Stick

1. Flash your M5StickC Plus 2 with the NANDA firmware
2. Connect to same WiFi network
3. Run the adapter:

M5STICK_URL=http://192.168.0.146 bun run m5stick

Waveshare UGV

1. Set up your UGV with ugv_jetson
2. Start the Flask server on the robot
3. Run the adapter:

UGV_URL=http://192.168.1.100:5000 bun run waveshare

Agent Discovery

Once running, other agents can discover your hardware:

import { discoverAgent } from '@qusd/nanda-skill';

const robot = await discoverAgent('http://192.168.1.100:3010');
console.log(robot.capabilities); // ['move_robot', 'get_sensors', ...]

// Send command
await sendMessage('http://192.168.1.100:3010', 'move forward slowly');

Why This Matters

Most AI agents are stuck in the cloud. These skills give them a body:

• Vision → Camera on M5Stick or UGV
• Motion → Motor control on UGV
• Sensing → IMU, ultrasonic, battery
• Communication → A2A protocol for multi-agent systems

Build robots that can hire other robots for tasks. 🤖→🤖

License

MIT

Links

• nanda-skill — A2A protocol SDK
• M5Stack — M5StickC Plus 2 hardware
• Waveshare UGV — Robot kits