Physical AI expertise for coding agents

Robium is an open-source robotics development harness. It gives your agent tested guidance for simulation, robot learning, ROS 2, visualization, infrastructure, and deployment.

terminal
npx robium-ai setup --agent codex
✓ robium plugin installed for Codex
codex

> scaffold a project: a LeRobot arm on a mobile ROS 2 base, LeRobot + Nav2, sim first
⚙ skills loaded: architect · lerobot · nav2 · simulation · environments

> set up the VLA fine tuning pipeline on RunPod with dataset from hugging face
⚙ skills loaded: environments · data · huggingface

> deploy the sim demo to Cloud Run
⚙ skills loaded: live-demo · cloud-run

01 Get Started

Install Robium

Choose your coding agent and copy the command.

npx robium-ai setup

02 Knowledge Layer

Robotics knowledge, organized by task

Architecture, simulation, data, visualization, infrastructure, and deployment—connected in one skill library.

03 Why Robium

Built from working systems

Guidance shaped by reference applications, documented failures, and tested integrations.

Tested in applications

Reference applications exercise the skills against real simulators, datasets, middleware, and deployment targets.

Updated from evidence

Build failures and verified fixes become reviewed updates to the skills that need them.

One connected stack

Robium covers architecture, ROS 2, simulation, data, training, visualization, testing, and deployment.

Works with your agent

Use the same skill library with Claude Code, Codex, Gemini CLI, or Cursor.

Less setup work

Skills carry working patterns for environments, integrations, simulators, and version compatibility.

Open source

The plugin, CLI, skills, references, and examples are available under the MIT license.

04 Skill Catalog

Browse the skills

Versioned guidance for the robotics tools and workflows Robium supports.

architect v2.2.0 Turns requirements into a full stack decision and a written architecture brief. stack selectiondesign

Entry-point skill for shaping new robotics applications: lightweight brainstorming, project ideation, requirement/risk discovery, stack selection, comparing or choosing simulators/models/visualization, a first user-visible slice, and a concise architecture decision record.

Related
gazebo v1.3.3 SDF worlds, sensors, the ros_gz bridge, and headless operation. GazeboSDFros_gz

Modern Gazebo (gz, Harmonic/Ionic line) simulation: SDF worlds and models, sensors (lidar, camera, IMU, contact), the ros_gz bridge, spawning robots, and headless/server operation.

Related
isaac-lab v1.1.3 RL and imitation learning on Isaac Sim. Isaac SimRLimitation

NVIDIA Isaac Lab: reinforcement-learning and imitation-learning workflows on top of Isaac Sim: prebuilt environments and tasks, training runs, and exporting policies.

Related
isaac-sim v1.1.2 GPU requirements, USD scenes, the ROS 2 bridge, headless operation. Isaac SimUSDGPU

NVIDIA Isaac Sim: installation and container setup, GPU/driver requirements, USD scenes, robots and sensors, the ROS 2 bridge, and headless/livestream operation for remote servers.

Related
mujoco v1.0.2 Lightweight, contact-rich manipulation simulation without ROS. MuJoCoMJCFmenagerie

MuJoCo for lightweight, contact-rich robot manipulation simulation on macOS/Linux, especially single-arm grasping without ROS: headless offscreen rendering, MJCF models, mujoco_menagerie assets, damped-least-squares inverse kinematics, and empirical grasp calibration.

Related
simulation v1.1.2 Choose the right simulator and simulate sensors correctly. GazeboIsaac Simsensors

Choose and set up robotics simulators, and simulate sensors correctly: Gazebo vs Isaac Sim selection, sensor fidelity (rates, noise models, frames matching the real robot), determinism, and sim-to-real considerations.

Related
data v1.2.3 Choose between offline datasets, sim-generated data, and teleop collection. Open X-Embodimentteleop

Data sourcing strategy for robotics and physical-AI: choose between offline datasets (HuggingFace hub, Open X-Embodiment and similar), simulation-generated data, and teleop/real-robot collection; plan storage formats, episode structure, and dataset versioning.

Related
huggingface v2.0.0 Hub datasets, models, demo Spaces. Hugging FaceHubSpaces

Hugging Face Hub operations for robotics projects: inspect, download, create, upload, authenticate safely, explore Dataset Viewer data, run and diagnose Jobs, and inspect Spaces.

Related
lerobot v2.2.0 Datasets, policy training, evaluation, and teleoperation. LeRobotACTSmolVLA

HuggingFace LeRobot for physical-AI manipulation: the LeRobotDataset format, loading and recording episodes, training policies (ACT, diffusion, pi0) and VLAs (SmolVLA), inspecting checkpoint processors, evaluating in simulation, LeRobot training-job lifecycle, and teleoperation.

Related
foxglove v1.6.0 Layouts, MCAP, remote visualization. Foxglovefoxglove_bridgeMCAP

Foxglove and Lichtblick for robotics visualization: foxglove_bridge setup for live ROS 2 robots, choosing the open-source Lichtblick client versus Foxglove, layouts, MCAP playback/recording, and remote web visualization.

Related
rerun v1.2.2 Log and view rollouts and streams. ReruntimelinesPython API

Rerun for data-centric robotics and ML visualization: logging APIs (Python), timelines, entity paths, and viewing policy rollouts, episode data, and sensor streams.

Related
rviz2 v1.0.3 TF debugging and display fixes. RViz2TFmarkers

RViz2 visualization for ROS 2: displays, TF frame debugging, markers, saved config files, and the common 'nothing shows up' fixes (fixed frame, QoS, sim time).

Related
visualization v1.0.4 Choose rviz2 vs Foxglove vs Rerun, and what to visualize when. rviz2 vs Foxglove vs Rerun

Choose and apply robotics visualization: selection guidance for rviz2 vs Foxglove vs Rerun, plus best practices: what to visualize at each dev stage, live vs recorded, local vs remote.

Related
environments v2.0.0 Decide uv vs Docker and make local and remote runs reproduce identically. uvDockerGPU

Virtual-environment-first setup for robotics projects: decide uv/venv vs Docker, make local and remote-server runs reproduce identically, handle GPU passthrough and headless/display forwarding.

Related
integration v1.2.3 Module boundaries, inter-module communication, and compose wiring. ROS 2zenohgRPC

Glue robotics modules into one running system: choose module boundaries, pick inter-module communication (ROS 2 topics/services/actions, zenoh, gRPC, REST, shared memory), and write solid Dockerfiles and docker-compose for robotics workloads.

Related
nav2 v1.5.1 Behavior trees, costmaps, and tuning. Nav2behavior treesAMCL

Nav2 mobile-robot navigation for ROS 2: bringup, behavior trees, costmaps, planner/controller servers, localization (AMCL, slam_toolbox), waypoint following, and tuning.

Related
ros2 v1.7.1 Workspaces, colcon, topics, QoS, TF2. ROS 2colconQoS

Core ROS 2 usage: workspaces, colcon builds, packages (ament_python/ament_cmake), nodes, topics/services/actions, QoS, launch files, parameters, TF2, rosdep, and gluing third-party packages together.

Related
cloud-run v1.0.3 Deploy sim containers to Cloud Run. Cloud RunArtifact RegistryWebSockets

Deploy headless robotics / sim / demo containers to Google Cloud Run: the build → Artifact Registry → Cloud Run path plus the gotchas that bite sim workloads (no UDP multicast for gz-transport/DDS, CPU allocated only while a request is open, session affinity for per-visitor instances, request timeout / concurrency for long-lived WebSockets, VPC subnet sizing).

Related
live-demo v2.0.0 Turn a working app into a public, interactive web demo. Cloud RunFoxglove

Add safe hosted-session runtime to a working robium app: per-visitor instances, a capability-protected gateway, start/status/stop lifecycle, boot logs, fleet budgets, Cloud Run or RunPod drivers, and a Gradio, Lichtblick, or Foxglove viewer handoff.

Related
app-publishing v2.0.0 Publish an implemented, smoke-tested Robium application as one coherent public project.

Publish an implemented, smoke-tested Robium application as one coherent public project: write or revise its product-lab article, prepare real-run media and explanatory assets, apply the Robium editorial cobalt theme, and compose catalog, overview, live, guide, and social surfaces from repository-owned facts.

learning-loop v1.2.0 Consolidates captured learnings into evidence-gated skill-update PRs. consolidateabsorbPRs

Robium's explicit learning engine: consolidate capture-only queue flags and transcript evidence into observations; absorb ready observations through deterministic anchor-targeted skill deltas; refine, A/B contested edits, deep-verify examples, prune landed transcript evidence, and report loop health.

Related
mining v0.1.2 Mines external repos for the catalog. external reposobservations

Registry-driven mining of external example repos: the learning engine's second experience source. Surveys, deep-reads, and comparatively analyzes approved repos (vendor demos, framework samples, community robot apps) into evidence-cited observations (origin: external) that harden robium skills or propose new ones; maintains crawl records for drift re-checks.

Related
runpod v0.1.0 Operate RunPod Pods safely: inspect balance, compare alternative GPU resources and US regions, launch immutable images, attach network volumes, expose services, diagnose logs/startup, validate workloads, and clean up paid compute.

Operate RunPod Pods safely: inspect balance, compare alternative GPU resources and US regions, launch immutable images, attach network volumes, expose services, diagnose logs/startup, validate workloads, and clean up paid compute.

skill-author v2.0.4 Authoring workflow and the quality bar. templatequality bar

Author new robium skills and enforce the catalog quality bar. Owns the authoring workflow from templates/skill, the quality bar (references/quality-bar.md: template compliance, trigger-surface descriptions, <500-line bodies, stated delegation posture, upstream links, no invented syntax), and scripts/validate_skills.py: run it after ANY skills/ change.

Related
test-assets v1.1.0 Canonical worlds, models, and datasets. worldsfixturesgolden policy

Canonical test assets and fixture sourcing for robotics testing: which worlds, robot models, sample datasets, and recordings to test against for a given robot type; the standard test-assets folder layout with a provenance catalog and per-asset manifests; pointer vs vendored sourcing modes; fixture and golden policy (tolerance bands, seeded generation).

Related
testing v1.4.3 Smoke tests, sim-based regression, policy eval, and CI patterns. launch testsCI

Test-driven robotics development: smoke tests for launch files, sim-based regression tests, node-level unit tests, policy eval as a test, and CI patterns for robotics repos.

Related

05 How It Fits

How Robium works

Your coding agent combines Robium's skills with the context in your project, then builds and tests against simulation, hardware, or cloud targets.

ROBIUM plugin + skills Architecture Middleware Simulation Data ML / Training Visualization Infrastructure Testing architect selects + loads the skills each task needs LEARNINGS Build sessions Repository patterns Versioned skill updates improves skills > build a mobile robot app with arm manipulation >_ YOUR AGENT claude codex gemini YOUR CONTEXT Application Codebase Company knowledge Custom hardware Internal docs grounds the agent TARGETS build · test · deploy robot simulation cloud builds feed learnings back

06 Blog

Latest from the blog

Practical tutorials and engineering notes from building robotics applications. All blog posts →

07 FAQ

Common questions

Which coding agents does Robium work with?

Claude Code, Codex, Gemini CLI, and Cursor. One command, npx robium-ai setup, detects the agents on your machine and sets up each one (or target one: --agent codex). The skills follow the open Agent Skills format, so any agent that speaks it can read them.

Do I need a robot or a GPU?

Not necessarily. Everything starts in simulation: PushT with Diffusion Policy evaluates a published policy on a GPU-less MacBook, and Robot Navigation runs Gazebo fully headless in Docker and as a private cloud demo. When a build does need muscle, the skills cover running the same stack on remote GPU servers and in the cloud.

What exactly is a skill?

A versioned folder of expertise your agent loads when a task calls for it: field-tested guidance (which simulator, which viewer, the failure modes docs don't mention) plus curated reference notes and runnable examples: real Dockerfiles, launch files, SDF worlds, and Python snippets. No invented syntax to learn; just knowledge your agent acts on.

Why not just ask my agent directly?

Frontier agents know robotics in general. They don't reliably know which Gazebo pairs with which ROS 2 release, or why a cloud-hosted sim needs a unicast relay. Skills pin that judgment and those facts, versioned and verified against real builds, so your agent doesn't re-derive or hallucinate them.

How do skills stay correct as the ecosystem moves?

The catalog runs a learning engine: build sessions capture what broke and what fixed it, mining pulls proven patterns from ecosystem repos, and evidence-gated pull requests fold both back into the versioned skills; a human merges every change. LeRobot's API churn has already forced a major version bump.

Can it capture my team's own knowledge?

Yes. Capture hooks log what breaks and what works during your builds, and the skill-author workflow turns that into skills for your own stack (your conventions, your hardware, your infra), hardened by the same loop that maintains the public catalog.

Is it free?

Yes, MIT-licensed. The plugin, the full skill catalog, and the CLI are open source at github.com/robium-ai.

Can I contribute a skill?

Yes, and the contribution unit is deliberately small: one skill. Copy the template, pass the validator, open a PR.