Skip to content
gunkslab

Fleet software for small robots, learned by doing.

Drive a fleet of small robots from your browser. Start with simulated bots on your own machine. When you have a real ESP32 bot, flash it and drive it from the same page.

Free, and it runs on your own machine. The code is in early access and planned to open on 30 November 2026, under the Apache 2.0 licence. Ask for access, then follow Install.

0:00 / 0:35

Click a bot, on the desk or here, to see what it's doing and only its messages.

A real run from the simulator, played back. Four bots swap corners, every path crosses the middle, and the station makes them wait or go round each other. Run it yourself with scripts/scenario watch four-corners. Tutorial 09 explains it.

The code is in early access. Ask for it in the issue tracker. You need a container runtime and nothing else. On macOS that's Apple's container, on Linux and Windows docker or podman. Install

The course

From a broker to a bot that sees, about 4 hours

Each stop builds on the last. Point at one to see what you'll do there.

  1. 01The MQTT broker30 minThe MQTT broker30 minRun the broker, then send and watch messages. Topics, wildcards, retained messages, QoS and last wills
  2. 02Protocol v0 by hand30 minProtocol v0 by hand30 minBe a bot and a station yourself, with nothing but the broker: hello, status, commands, telemetry, events, the e-stop
  3. 03The simulator and the viewer30 minThe simulator and the viewer30 minSimulated bots on a desk in your browser: drive them, find one, e-stop them, crash them
  4. 04The driving tool20 minThe driving tool20 minDrive from the keyboard: speed and turn, reading the echo, a power cap, switching bots, the e-stop, a client that dies
  5. 05The station30 minThe station30 minTalk to the station by hand: driving through it, its dead-man, one driver per bot, refusals, a fleet power cap, a crash
  6. 06The driving page20 minThe driving page20 minDrive from the browser with the keys, the on-screen pad or a gamepad. Two drivers at once, and the e-stop from the page
  7. 07Send a bot somewhere20 minSend a bot somewhere20 minClick the desk and the station drives the bot there: how it steers, taking over, and every way a trip can end
  8. 08Scenarios25 minScenarios25 minSet up a situation and say what must happen: run them, watch one in the page, write your own, the stress test, and how CI treats them
  9. 09Keeping out of the way20 minKeeping out of the way20 minHow the station keeps bots from running into each other on a go-to: the rules, watching them, the desk's edges, and where they stop
  10. 10The distance sensor20 minThe distance sensor20 minThe bot's own front sensor and its reflex: put a box on the desk, drive into it, back off, and a go-to it can't finish
The robots

One protocol, from a desk car up