truerig 0.1.0

Robot-model conversion (URDF/MJCF/USD) you can trust — with a fidelity report of everything it changed.

TrueRig

Robot-model conversion you can trust. Convert robot descriptions between URDF ↔ MJCF ↔ USD through a lossless canonical IR — and get a fidelity report of everything that changed.

The thesis is the point: existing converters fail silently. TrueRig's product is knowing what you lost.

Why

Every open-source URDF→MJCF converter today fails on real robots, silently. We reproduced this against the current urdf2mjcf (MuJoCo 3.10) on two standard models:

Defect	Robot	Existing tool behaviour
Off-diagonal inertia dropped on 32 links (up to 31.5% of the diagonal)	Unitree G1	one buried "Warning" line
Closed-chain coupling (5 mimic joints → 0 constraints)	Robotiq 2F-85	no warning at all
package:// mesh URIs passed through unresolved / doubled paths	both	hard load error
Invalid MJCF emitted (empty-name material)	Robotiq	MuJoCo refuses the file

Out of the box, neither converted model even loads in MuJoCo without manual fixing — and once you fix the plumbing, the physics is still silently wrong.

3 of the 4 defects are pure engineering diligence. The 4th (closed chains) is genuinely lossy — so TrueRig's job isn't to pretend loss doesn't happen, it's to preserve everything it can and report the rest honestly.

How it works

 URDF ─┐                          ┌─ MJCF
 MJCF ─┼─► frontend ─► IR ─► backend ─┼─ URDF      + validate(IR)  → physics checks
 USD  ─┘   (parse)   (lossless)  (emit) └─ USD      + report(loss_log) → what changed

The IR is frozen (truerig/ir.py) and is lossless by construction: frontends record all source data; backends drop only what the target can't express and log a LossEvent for each drop. See module docstrings for per-component contracts.

Status

Early scaffold. Component contracts are defined as stubs; see the task board. Baseline defect harness that motivates the project: examples/stress_baseline.py.

Quickstart (target UX)

truerig convert robot.urdf robot.xml --report text --strict
truerig validate robot.urdf
truerig simcheck robot.urdf robot.xml