Files
2026-11-03 19:46:08 +08:00

5.2 KiB

Vendored backend sources and assets

Like Jumper's rl/ layout, this project installs backend copies as top-level packages through pip install -e . / uv sync, not through working-directory-dependent import tricks. rl/ deliberately has no __init__.py. Package discovery includes namespaces: upstream's mjlab/scripts has no initializer but still contains real source that must be included in wheels.

Path Source Baseline License
rl/mjlab/ mujocolab/mjlab plus recorded local changes 1.6.0, commit in rl/upstream/import.json Apache-2.0; embedded components retain their licenses
rl/rsl_rl/ Installed rsl-rl-lib release, checked against its distribution RECORD hashes 5.5.1 BSD-3-Clause
rl/mjlab/asset_zoo/robots/booster_t1/assets/ BoosterRobotics/booster_assets T1_23dof.xml and its referenced meshes; commit recorded BSD-3-Clause
rl/mjlab/asset_zoo/robots/unitree_g1/ mjlab's adapted MuJoCo Menagerie model Preserved with upstream mjlab assets Unitree BSD-3-Clause

What was imported

The mjlab copy contains tracked package files from the validated checkout, including its two modified runtime files, plus the T1 robot/task Python modules. Unrelated private/untracked Apollo/R1 experiments, prompts, logs, environments and keyboard applications are not imported. Other tracked upstream example assets remain intact; their presence does not register them as supported Universal Humanoid tasks.

RSL-RL Python files were verified against the installed release's RECORD before copying. No algorithm changes were applied. Its release METADATA and upstream mjlab pyproject are preserved under rl/upstream/, without creating separately installed backend distributions.

Explicit differences

File Origin / purpose
rl/mjlab/sim/sim.py Retains the pre-existing local patch suppressing only LS_ITERATIONS/ITERATIONS warnings. This is not evidence of solver convergence; other overflow warnings remain.
rl/mjlab/tasks/velocity/mdp/velocity_command.py Retains configurable min_forward_velocity; T1 uses a smaller minimum than G1.
rl/mjlab/asset_zoo/robots/booster_t1/t1_constants.py The imported T1 adapter now defaults to bundled assets, with an explicit optional BOOSTER_ASSETS_ROOT override. No personal HOME fallback.
rl/mjlab/tasks/velocity/config/booster_t1/ T1 environment, PPO configuration and reward extension, previously external/untracked, now included.

The first two inherited changes are preserved as the actual upstream-relative diff in rl/upstream/mjlab-local.patch; their regression tests and the imported T1 test are retained in rl/upstream/tests/ as reference material. They are not automatically mixed into this project's pytest suite. Our adapter/conformance/behavior tests exercise the supported integration. Changed runtime files carry [uh-vendor] notices. The initial source inventory is rl/upstream/import.json; the current distributable inventory is rl/VENDOR.json.

Verify and update deliberately

python3 tools/vendor_manifest.py
./scripts/uh verify-vendor

Built-wheel resource parity can also be checked with python3 tools/check_wheel.py dist/universal_humanoid-0.2.0-py3-none-any.whl after uv build --wheel. It checks all package sources, model resources and licenses against the checkout, catching missing namespace modules that an editable install could conceal.

Both inventory commands compare every non-cache file under rl/ against recorded SHA-256 hashes; extra, missing and modified files fail. No updater runs automatically. For a reviewed vendor revision:

  1. Record the upstream release/commit, licenses and inherited patches.
  2. Make changes in this repository only, adding a clear modification notice to changed source.
  3. Update this document and review the diff against the initial import inventory.
  4. Run the adapter, negative conformance, setup and GPU pipeline checks.
  5. Explicitly record the accepted files with python3 tools/vendor_manifest.py --record.
  6. If dependencies changed, regenerate uv.lock and its pip export, and repeat clean-install checks.

A hash inventory detects accidental drift; it does not prove safety or authenticate arbitrary code. A deliberate hash refresh without review defeats its purpose. Source snapshots/provenance now include RSL-RL source identity, robot declarations and the dependency lock, not just mjlab.

Licensing and distribution

License texts travel inside both package directories and are included as wheel resources. The mjlab assets and Isaac Lab-derived helpers carry their corresponding license texts in rl/mjlab/licenses/; RSL-RL's dependencies and pfrl attribution are under rl/rsl_rl/licenses/. T1 assets carry their own assets/LICENSE. See NOTICE.md for attribution.

The upstream licenses do not automatically choose a license for this project's original code or settle authorship of downstream additions. Select that license and review downstream attribution before announcing an open-source release. No credentials or proprietary robot transport code is included, and no physical deployment support is implied.