Open-source micromouse · ESP32 · simulation first

Ariadne.

A micromouse that designs its own turns, plans in seconds instead of cells, and proves every manoeuvre in a 10 kHz physics model running the exact firmware control law, before a single part is soldered.

GitHub · MIT · Python + C++17/11 · 115 Python tests · C++ planner bit-identical to the simulator

2.4×faster fast run than
stop-and-pivot (physics)
30clothoid turns, each
≥ 12 mm from any wall
54° / 47°phase margin, forward /
rotation loop at 1 kHz
32 / 32smooth runs finished,
randomised robots

Same maze. Same physics. Three generations.

Real trajectories from the simulator, played back in real time. Each robot runs the firmware's control law on a model with motor dynamics, tyre friction circles, encoder and PWM quantisation, a noisy gyro and ToF sensors. Colour is speed.

0.00 s

From maze to motor voltage

  1. Searchflood fill, stops when the path is provably optimal
  2. PlanDijkstra on edges × 8 headings, 30-turn library
  3. Speed planforward / backward pass, exact time
  4. Run1 kHz plan runner, closed-form heading reference
  5. Trackpath following on the pose estimate
  6. Observewalls → offset, heading, gyro bias, along-track

Where it stands

The simulator, planners, estimator and firmware are complete and tested. The firmware builds for the ESP32 with zero warnings. It has not driven a real maze yet: the next step is hardware, and that is where sponsorship comes in.

Read the roadmap
  • v1 flood fill, pivot planner, physics model, ESP32 firmware
  • v2 clothoid turns, diagonals, path following, wall observer
  • v3 design studies, website, custom-PCB proposal
  • Next build and validate on a real maze, publish flight logs
  • Then custom PCB: IR sensors at 1 kHz, better IMU, compact low-inertia chassis

Help put Ariadne on real wheels

The studies say exactly what the next hardware buys: a compact PCB chassis raises the angular acceleration that caps every turn, 1 kHz IR sensors cut path error, a better IMU makes diagonals viable. Your support pays for the boards, parts and test maze, and everything that comes out of it stays open.