Welcome to RoboAgent

RoboAgent is the AI-native development environment for robots. These docs walk you from installation to your first sim-validated patch on a real robot.

Core concepts

• Robotics Knowledge Graph (RKG) — typed graph of nodes, topics, services, params, TF, URDF, hardware.
• Launch IR — symbolic execution of .launch.py resolved into a queryable IR.
• Bag Index — MCAP / rosbag2 indexed in DuckDB for time-windowed, cross-topic queries.
• Sim-in-the-loop — closed-loop agent that proposes, runs, observes, and iterates in sim.
• Tools — typed, sandboxed actions the agent can call: rkg.query, bag.query, sim.run, code.edit, deploy.push.

Your first session

# 1. install
sudo apt install ./roboagent_0.4.2_amd64.deb

# 2. open your workspace
cd ~/ros2_ws && roboagent .

# 3. ask
> Why is /cmd_vel arriving 200ms late?