Robot stack
Middleware, navigation, integration, and reproducible environments.
Robium is an open-source robotics development harness. It gives your agent tested guidance for simulation, robot learning, ROS 2, visualization, infrastructure, and deployment.
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
Choose your coding agent and copy the command.
npx robium-ai setup 02 Knowledge Layer
Architecture, simulation, data, visualization, infrastructure, and deployment—connected in one skill library.
Middleware, navigation, integration, and reproducible environments.
Build and test the robot before hardware enters the loop.
Source robot data and train the policies that consume it.
Inspect live robots, simulations, rollouts, and recorded data.
Prove the application works, then turn it into a runnable demo.
Capture evidence and keep Robium's expertise improving.
New skills awaiting a permanent place in the catalog.
03 Why Robium
Guidance shaped by reference applications, documented failures, and tested integrations.
Reference applications exercise the skills against real simulators, datasets, middleware, and deployment targets.
Build failures and verified fixes become reviewed updates to the skills that need them.
Robium covers architecture, ROS 2, simulation, data, training, visualization, testing, and deployment.
Use the same skill library with Claude Code, Codex, Gemini CLI, or Cursor.
Skills carry working patterns for environments, integrations, simulators, and version compatibility.
The plugin, CLI, skills, references, and examples are available under the MIT license.
04 Skill Catalog
Versioned guidance for the robotics tools and workflows Robium supports.
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.
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.
NVIDIA Isaac Lab: reinforcement-learning and imitation-learning workflows on top of Isaac Sim: prebuilt environments and tasks, training runs, and exporting policies.
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.
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.
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.
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.
Hugging Face Hub operations for robotics projects: inspect, download, create, upload, authenticate safely, explore Dataset Viewer data, run and diagnose Jobs, and inspect Spaces.
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.
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.
Rerun for data-centric robotics and ML visualization: logging APIs (Python), timelines, entity paths, and viewing policy rollouts, episode data, and sensor streams.
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).
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.
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.
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.
Nav2 mobile-robot navigation for ROS 2: bringup, behavior trees, costmaps, planner/controller servers, localization (AMCL, slam_toolbox), waypoint following, and tuning.
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.
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).
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.
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.
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.
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.
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.
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.
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).
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.
No skills match . Try a broader term.
05 How It Fits
Your coding agent combines Robium's skills with the context in your project, then builds and tests against simulation, hardware, or cloud targets.
06 Blog
Drive a simulated TurtleBot3, build a map, localize, save waypoints, and watch Nav2 plan in a browser workspace.
Connect camera, robot state, and one instruction to a Panda arm, then keep the GPU run separate from the fixture-backed browser workspace.
Replay a bimanual transfer on macOS, inspect its 100-action chunks, and keep the published benchmark separate from local runs.
A failed ACT configuration led to a task-matched checkpoint, a careful compatibility adapter, and a faster way to inspect PushT on macOS.
A recovered Isaac Lab run turns policy training into a recorded progression, backed by a fresh capability-scoped GPU smoke.
07 FAQ
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.
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.
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.
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.
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.
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.
Yes, MIT-licensed. The plugin, the full skill catalog, and the CLI are open source at github.com/robium-ai.
Yes, and the contribution unit is deliberately small: one skill. Copy the template, pass the validator, open a PR.