xlerobot-onboard

Setup script + Claude skill that get you from "fresh laptop" to "calibrated XLeRobot running teleop" without fighting the install ritual.

Born at the MakerMods + XLeRobot hackathon (May 2026).

Quick start

git clone https://github.com/ScavieFae/xlerobot-onboard
cd xlerobot-onboard
uv venv --python 3.12 .venv && source .venv/bin/activate
./xlerobot-install --use-uv

The script:

• Clones huggingface/lerobot v0.5.1 and Vector-Wangel/XLeRobot at a pinned SHA.
• Copies the xlerobot robot classes + IK solver into the lerobot tree.
• Runs pip install -e ".[feetech]" so Python can find them.
• Verifies the imports actually resolve.

Defaults to installing into ./lerobot-xlerobot/. See ./xlerobot-install --help for flags.

Why this exists

XLeRobot's official install doc tells you to "Move the xlerobot folder into /robots", "Move the IK solver into /model", "Move all the example codes to /example folder" — three prose instructions, no commands, no mention that you need to re-run pip install -e . against the modified tree. So most "ModuleNotFoundError: No module named lerobot.robots.xlerobot" reports on the upstream tracker (issues #89, #92) trace to the same missing reinstall step.

This script automates the file-copy ritual, re-runs the install, and verifies the imports — so you find out whether it's working in 5 minutes, not 5 hours.

Claude skill

If you use Claude Code, this repo also ships a skill that orchestrates the install and walks through post-install hardware setup (motor IDs, port discovery, calibration, first teleop).

Project-scoped — Claude Code picks it up automatically when launched from this folder.

Global install — available everywhere:

mkdir -p ~/.claude/skills
cp -r .claude/skills/xlerobot-onboard ~/.claude/skills/

Trigger with /xlerobot-onboard or natural language: "set up xlerobot."

Pinned versions

Component	Pinned to
huggingface/lerobot	v0.5.1
Vector-Wangel/XLeRobot	51ca0ec (May 2026)
Python	≥ 3.12 (lerobot requirement)

Override pins with --lerobot REF and --xlerobot REF, or via env vars (LEROBOT_REF, XLEROBOT_REF).

Acknowledgments

• LeRobot — Hugging Face
• XLeRobot — Vector Wang
• MakerMods — Ryan Chan, Isaac Sin, and crew
• The autocalibrator PR (lerobot#3282) by Isaac Sin, which solves the next DX wall after this one.

License

MIT — see LICENSE.

---

Built at New Theory AI in service of NT-0 — open developer tools for putting policies on real robots.