Marblebeests (Physical marble runs as scannable programs)

Marblebeests is a system in which physical marble runs built from 3D-printed tiles are the program. A companion app scans the physical construction, uses a vision-language model to parse the topology into an intermediate representation, and either executes that program against test cases (puzzle mode), streams commands to a connected Raspberry Pi robot (robot mode), or runs a simulation. The physical marble run is the source code; building it, debugging it, and rebuilding it is the programming act. The system is realised through three tightly coupled components: a library of 3D-printable tile types that encode computational primitives, a mobile app that handles scanning, LLM parsing, execution, and feedback, and a Raspberry Pi hardware layer for physical output. These components are described in detail below, followed by five complete set definitions.