AMR Platform
Running · simulated robots
An outdoor fleet platform with a safety state machine, traffic reservations and a costmap built from OpenStreetMap.
- lines of Python
- 27,103106 modules
- tests
- 652across 40 files
- costmap resolution
- 0.5 m1600 × 1600 cells in ~2 s
- final error
- 0.7 mafter a 623 m simulated drive
AMR Platform in short
The production-shaped version for outdoor fleets: FastAPI and SQLite, a validated safety state machine, tiered emergency stop, stuck detection with rerouting, and a range-based battery policy that recalls a robot before it strands. Hardware integration lives behind explicit interfaces, so nothing pretends a physical safety layer exists when it does not.
What works, and what does not
- Robots report telemetry through the same path a physical machine uses; a supervisor watches at 10 Hz
- Validated safety state machine and tiered emergency stop
- Stuck detection with rerouting around blockages the fleet has actually observed
- Range-based battery policy that recalls a robot before it strands
- Four road-rule profiles: pedestrian, service, road, expressway
- There is no hardware safety controller. The API reports hardware_safety: false until one is built and commissioned on a bench.
- Driving a mission on a physical robot needs ROS 2 on the robot; the Nav2 backend refuses to start without it.
- The stop button in the browser is a remote operational stop, not a safety function.
What had to be got right
Nothing is drivable by default
The importer emits only what it can justify from mapped ways and areas. Everything else stays unknown — and unknown is not traversable.
Road rules are a profile, not a price
A main road is not merely expensive: a pedestrian profile cannot use it, so a planner never sends a robot down the middle of a public street.
Wait, go round, then ask a person
Eight seconds first, then replan around the fleet-wide map of observed blockages (up to three attempts), then stop and ask once.
Ground is granted, not assumed
A robot may move only into space the fleet has reserved for it, in four-metre tiles, with leases so a robot that loses power stops holding the corridor.
The real build, recorded
Related projects
Robot Fleet Manager
A single-file controller that drives a real fleet from a Jetson on the shelf.
Open →AMR Flow Simulator
A browser tool that sizes a robot fleet for a warehouse before one is bought.
Open →Terra
A civilization simulation in continuous time on a real sphere — no turns, no visible hex grid.
Open →Figures describe this project's own build at the time of writing, not a promise of anything else. All projects and statuses.