Skip to content
Back to search

robium

Physical AI skills for coding agents, with field-tested robotics guidance, the robium-ai CLI, and a learning engine.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/robium-ai--robium/badge.svg)](/listings/robium-ai--robium)

HTML

<a href="/listings/robium-ai--robium"><img src="/api/listings/robium-ai--robium/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need Node.js 18+, Git, and at least one supported coding agent.

npx robium-ai setup
npx robium-ai doctor

Setup detects your agents and asks where to create the workspace. To install for one agent or choose the location up front:

npx robium-ai setup --agent codex
npx robium-ai setup --dir ~/projects/my-robotics

This is an **editable install**, not a hidden package snapshot. Setup creates ordinary Git checkouts and connects your agent to them:

~/robium-workspace/       # default; location and name are your choice
├── robium/               # editable skills and plugin source
└── robium-apps/          # runnable reference applications

Run `npx robium-ai workspace` anytime to find them. After editing or manually updating Robium, run `npx robium-ai setup` again and restart your agent so its integration refreshes.

Install skills only

To add Robium's skills to an existing project with the [skills CLI](https://skills.sh/), run:

npx skills add robium-ai/robium

Choose skills interactively, or select them by name:

npx skills add robium-ai/robium --skill ros2 gazebo mujoco

This installs the skill instructions and their supporting files. For the complete Robium workspace, reference applications, and plugin integration, use `npx robium-ai setup` above.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "robium",
  3. "owner": {
  4. "name": "robium-ai"
  5. },
  6. "metadata": {
  7. "description": "Self-improving robotics skills for coding agents",
  8. "version": "0.5.2"
  9. },
  10. "plugins": [
  11. {
  12. "name": "robium",
  13. "source": "./",
  14. "description": "Self-improving robotics expertise for AI agents: stack selection, simulation, visualization, data, testing, and training skills for physical-AI applications"
  15. }
  16. ]
  17. }
README.md · README · 171 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="assets/brand/robium-lockup-dark.png">
  4. <img src="assets/brand/robium-lockup.png" alt="robium" width="360">
  5. </picture>
  6. ### Physical AI skills for coding agents
  7. Robium gives Claude Code, Codex, Gemini CLI, and Cursor field-tested robotics
  8. skills, troubleshooting guidance, and runnable reference applications. Start
  9. with a working robot, then ask your agent to adapt it.
  10. [![skills](https://github.com/robium-ai/robium/actions/workflows/skills.yml/badge.svg)](https://github.com/robium-ai/robium/actions/workflows/skills.yml)
  11. [![skills.sh](https://skills.sh/b/robium-ai/robium)](https://skills.sh/robium-ai/robium)
  12. [![Website](https://img.shields.io/badge/robium.ai-website-4c8bf5)](https://robium.ai)
  13. [![npm](https://img.shields.io/npm/v/robium-ai?label=npm%20robium-ai&color=cb3837)](https://www.npmjs.com/package/robium-ai)
  14. [![License: MIT](https://img.shields.io/badge/license-MIT-3da638)](./LICENSE)
  15. [![Discord](https://img.shields.io/badge/Discord-Robium-5865F2?logo=discord&logoColor=white)](https://robium.ai/join/discord)
  16. </div>
  17. ## Introducing Robium
  18. https://github.com/user-attachments/assets/90eed7a7-d240-4e64-bd2a-6a7d6290be46
  19. [Watch on YouTube](https://www.youtube.com/watch?v=y1a3PakIQsQ)
  20. ## Install
  21. You need Node.js 18+, Git, and at least one supported coding agent.
  22. ```bash
  23. npx robium-ai setup
  24. npx robium-ai doctor
  25. ```
  26. Setup detects your agents and asks where to create the workspace. To install
  27. for one agent or choose the location up front:
  28. ```bash
  29. npx robium-ai setup --agent codex
  30. npx robium-ai setup --dir ~/projects/my-robotics
  31. ```
  32. This is an **editable install**, not a hidden package snapshot. Setup creates
  33. ordinary Git checkouts and connects your agent to them:
  34. ```text
  35. ~/robium-workspace/ # default; location and name are your choice
  36. ├── robium/ # editable skills and plugin source
  37. └── robium-apps/ # runnable reference applications
  38. ```
  39. Run `npx robium-ai workspace` anytime to find them. After editing or manually
  40. updating Robium, run `npx robium-ai setup` again and restart your agent so its
  41. integration refreshes.
  42. ### Install skills only
  43. To add Robium's skills to an existing project with the
  44. [skills CLI](https://skills.sh/), run:
  45. ```bash
  46. npx skills add robium-ai/robium
  47. ```
  48. Choose skills interactively, or select them by name:
  49. ```bash
  50. npx skills add robium-ai/robium --skill ros2 gazebo mujoco
  51. ```
  52. This installs the skill instructions and their supporting files. For the
  53. complete Robium workspace, reference applications, and plugin integration,
  54. use `npx robium-ai setup` above.
  55. ## Try a working robot
  56. Restart your agent after setup, open it in a folder where it may work, and paste
  57. one of these prompts. Robium will inspect the matching reference app, check the
  58. prerequisites, and aim for a visible result before suggesting custom work.
  59. ### Map and navigate a simulated home
  60. <a href="https://github.com/robium-ai/robium-apps/tree/main/robot-navigation"><img src="https://raw.githubusercontent.com/robium-ai/robium-apps/main/robot-navigation/assets/stills/readme-navigation.png" alt="A simulated TurtleBot mapping and navigating a home" width="700"></a>
  61. > Map a simulated house with ROS 2, Gazebo, and SLAM, then navigate the robot to a goal.
  62. This uses the stable `robot-navigation` example with ROS 2, Nav2, Gazebo, and a
  63. bundled browser viewer. Docker with Compose v2 is required. A successful first
  64. run creates and saves a map, localizes the robot on it, and reaches a navigation
  65. goal.
  66. To run the example directly instead:
  67. ```bash
  68. npx robium-ai app doctor robot-navigation
  69. npx robium-ai app run robot-navigation
  70. ```
  71. ### Run a pretrained two-arm policy
  72. > Help me run a pretrained policy that transfers a cube between two simulated robot arms.
  73. This uses the official ACT checkpoint in `act-aloha-cube-transfer`. There is no
  74. training step and no dedicated GPU is required. The first run prepares the
  75. locked environment and downloads the pinned model; success means the viewer
  76. opens, real inference runs, and the default cube-transfer result is reported.
  77. ```bash
  78. npx robium-ai app doctor act-aloha-cube-transfer
  79. npx robium-ai app run act-aloha-cube-transfer
  80. ```
  81. The native path is tested on Apple Silicon. Ask your agent to check the app
  82. README before using another platform.
  83. ### Build a robot assistant
  84. > Help me build a simulated robot assistant that understands what it sees and follows natural-language instructions.
  85. This starts from `silly-turtlebot`: a camera-equipped TurtleBot simulation with
  86. guarded navigation tools. It requires Docker and your own authorized Gemini
  87. Robotics access. Live model calls may cost money, so Robium checks access before
  88. starting and will not present a mock run as a live result.
  89. More applications and hosted demos are at [robium.ai](https://robium.ai) and in
  90. [robium-apps](https://github.com/robium-ai/robium-apps).
  91. ## Make it yours
  92. Keep the shipped examples clean and create an editable derivative in your own
  93. `my-apps/` directory:
  94. ```bash
  95. npx robium-ai app new my-navigation --from robot-navigation
  96. ```
  97. Then open that new app with your coding agent and describe one change. Robium
  98. will reuse the proven environment and test shape instead of rebuilding the
  99. whole stack from scratch.
  100. Useful commands:
  101. ```bash
  102. npx robium-ai app list # browse every reference app
  103. npx robium-ai skills nav # search the skill catalog
  104. npx robium-ai update --check # check upstream without changing files
  105. npx robium-ai update # update clean main branches safely
  106. ```
  107. ## What is included
  108. - Skills for ROS 2, Nav2, Gazebo, MuJoCo, Isaac Sim/Lab, LeRobot, robot data,
  109. visualization, testing, and deployment.
  110. - An architect that selects a compatible reference app and proves the smallest
  111. useful robot behavior first.
  112. - Capture and learning tools that turn verified build findings into better
  113. guidance without requiring raw agent transcripts.
  114. - A zero-dependency CLI for setup, diagnosis, updates, skills, and application
  115. lifecycle commands.
  116. See the [CLI guide](cli/README.md) for host-specific setup and update behavior,
  117. or [CONTRIBUTING.md](CONTRIBUTING.md) to improve a skill. Questions are welcome
  118. on [Discord](https://robium.ai/join/discord) and in
  119. [GitHub Discussions](https://github.com/robium-ai/robium/discussions).
  120. ## License
  121. [MIT](LICENSE)
scripts/bootstrap.sh · Bundled script · 64 lines · 1 finding marked
  1. #!/usr/bin/env bash
  2. # robium dev bootstrap — run from a clone: ./scripts/bootstrap.sh
  3. #
  4. # DEFAULT (anyone, incl. public contributors — NO secrets, NO Doppler needed):
  5. # installs uv + npm deps and runs the repository check. That's all you need to
  6. # author skills and work on the CLI locally.
  7. # ./scripts/bootstrap.sh
  8. #
  9. # MAINTAINER / OPERATOR (adds Doppler-managed secrets — only for publishing the
  10. # CLI, deploying the site, RunPod/NGC/GCP work):
  11. # ./scripts/bootstrap.sh --secrets # laptop (after `doppler login`)
  12. # DOPPLER_TOKEN=dp.st.dev.… ./scripts/bootstrap.sh # server (auto-enables)
  13. set -euo pipefail
  14. say() { printf '\033[1;36m▸ %s\033[0m\n' "$*"; }
  15. # run from the repo (the script lives in scripts/, so root is one level up)
  16. ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
  17. cd "$ROOT"
  18. [ -f skills/skill-author/scripts/validate_skills.py ] || {
  19. echo "Run this from a robium clone (./scripts/bootstrap.sh)." >&2; exit 1; }
  20. # secrets are OPT-IN: --secrets flag, or DOPPLER_TOKEN present (server case)
  21. WITH_SECRETS=0
  22. [ "${1:-}" = "--secrets" ] && WITH_SECRETS=1
  23. [ -n "${DOPPLER_TOKEN:-}" ] && WITH_SECRETS=1
  24. # 1) Toolchain + deps (no secrets involved) ----------------------------------
  25. command -v uv >/dev/null 2>&1 || { say "Installing uv…"; curl -LsSf https://astral.sh/uv/install.sh | sh; }
  26. if command -v npm >/dev/null 2>&1; then
  27. [ -d cli ] && { say "npm deps: cli/"; (cd cli && npm ci --silent 2>/dev/null || npm install --silent); }
  28. fi
  29. # 2) Sanity check the core dev loop works (no secrets) -----------------------
  30. if command -v uv >/dev/null 2>&1; then
  31. say "Running repository checks…"; ./scripts/check.sh
  32. fi
  33. # 3) Secrets (maintainer-only, opt-in) ---------------------------------------
  34. if [ "$WITH_SECRETS" = "1" ]; then
  35. say "Secrets: setting up Doppler…"
  36. if ! command -v doppler >/dev/null 2>&1; then
  37. if command -v brew >/dev/null 2>&1; then brew install dopplerhq/cli/doppler
  38. else curl -Ls https://cli.doppler.com/install.sh | sh; fi
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 42 on GitHub
  39. fi
  40. if [ -z "${DOPPLER_TOKEN:-}" ] && ! doppler whoami >/dev/null 2>&1; then
  41. echo " Need Doppler auth: run 'doppler login' or set DOPPLER_TOKEN, then re-run with --secrets." >&2
  42. else
  43. [ -z "${DOPPLER_TOKEN:-}" ] && doppler setup --no-interactive -p robium -c dev >/dev/null
  44. if doppler run --project robium --config dev -- sh -c 'test -n "${NPM_TOKEN:-}"' >/dev/null 2>&1; then
  45. say "Doppler secrets reachable ✓ — run privileged tasks with: doppler run -- <cmd>"
  46. else
  47. echo " Could not read secrets — check DOPPLER_TOKEN / login." >&2
  48. fi
  49. fi
  50. else
  51. say "Secrets skipped (maintainer-only: CLI publish, site deploy, RunPod/NGC/GCP)."
  52. echo " Need them? re-run: ./scripts/bootstrap.sh --secrets (see docs/secrets.md)"
  53. fi
  54. cat <<DONE
  55. ▸ robium ready.
  56. Contribute (no secrets): ./scripts/check.sh
  57. Privileged tasks: doppler run -- <command> (after --secrets setup)
  58. DONE

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.