80 lines
5.2 KiB
Markdown
80 lines
5.2 KiB
Markdown
# 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](https://github.com/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](https://github.com/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
|
|
|
|
```bash
|
|
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](../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.
|