Waldo Commander

A web interface for controlling robotic arms, currently tested with the PAROL6 robot.

https://github.com/user-attachments/assets/61c5aec4-9611-4f61-b1b0-35f25931e11e

• Browser-based. Control from any device on the network without being tethered to the arm.
• Python programs. Write robot programs in Python with loops, math, and libraries. Built-in editor with auto-complete, live output, and step-through debugging.
• 3D simulation. Preview motion paths, check reachability, and scrub through the timeline — no physical robot needed.
• Teach by demonstration. Control the robot live and record the motions as Python code.
• AI control (MCP). A built-in Model Context Protocol server lets an LLM (Claude Code, Claude Desktop, …) read status, author and run programs, and drive the arm — with per-mode approval you control. See AI Control (MCP).
• Backend-agnostic. Robot-specific logic lives behind the waldoctl abstraction layer. Other robots can be integrated by implementing the same interfaces — see the Backend Development Guide.

Quick start

git clone https://github.com/Jepson2k/Waldo-Commander.git
cd Waldo-Commander
pip install -e ".[parol6]"
waldo-commander

Open the printed URL. No robot connected? The app auto-starts in simulator mode so you can explore.

For connecting hardware, platform-specific setup, and configuration, see Getting Started.

Links

• Documentation
• waldoctl — robot backend abstraction layer
• PAROL6 hardware

Safety

• This software provides no safety guarantees and assumes no liability
• User accepts full responsibility for robot operation
• Simulator mode is not physics-accurate and does not guarantee repeatability on real hardware
• The digital E-STOP is not a substitute for the hardware emergency stop
• Incorrect kinematics calculations could result in sudden robotic movements
• Keep clear of all moving parts during operation

License

Apache-2.0. See NOTICE for the attribution notices redistributors must preserve.