Self-host public model assets

Author: abcamiletto

README.md

@@ -66,7 +66,7 @@ work can use `skip_vertices=True` to avoid preparing rest vertices.
 - Anatomicals: SKEL, MyoFullBody
 - Heads: FLAME
 - Hands: MANO
-- Robots: BrainCo, G1
+- Robots: BrainCo, G1, SmplHumanoid
 
 See the [model docs](https://abcamiletto.github.io/body-models/#supported-models)
 for setup, supported backends, inputs, and model-specific behavior.

docs/index.md

@@ -56,6 +56,7 @@ uv add "body-models[jax]"
 | --- | --- | --- |
 | [BrainCo](models/brainco.md) | BrainCo Revo 2 robotic hand | auto-download |
 | [G1](models/g1.md) | Unitree G1 rigid links | auto-download |
+| [SmplHumanoid](models/smpl-humanoid.md) | SMPL-compatible humanoid MJCF variants | auto-download |
 
 ## Common Usage
 

docs/models/anny.md

@@ -4,7 +4,9 @@ ANNY is a phenotype-driven body model with configurable rig and topology variant
 
 ## Setup
 
-ANNY downloads automatically on first use. To prefetch and save the path:
+ANNY downloads automatically on first use from `https://huggingface.co/abcamiletto/body-models`.
+The Hugging Face repo records the original ANNY Apache 2.0 and MPFB2 CC0 provenance. To prefetch
+and save the path:
 
 ```bash
 # Download the ANNY assets and store their path in the body-models config.

docs/models/brainco.md

@@ -4,7 +4,7 @@ BrainCo is a rigid articulated model of the BrainCo Revo 2 robotic hand using th
 
 ## Setup
 
-BrainCo downloads automatically on first use. To prefetch and save the path:
+BrainCo downloads from the public [`abcamiletto/body-models`](https://huggingface.co/abcamiletto/body-models) Hugging Face repository on first use. To prefetch and save the path:
 
 ```bash
 # Download the BrainCo MuJoCo XML and STL assets.
@@ -13,6 +13,8 @@ body-models download brainco
 
 When passed manually, `model_path` should contain `left.xml`, `right.xml`, and `meshes/{left,right}/*.STL`.
 
+The original BrainCo Revo2 description license is included with the hosted assets.
+
 ## Usage
 
 ```python

docs/models/g1.md

@@ -4,7 +4,9 @@ G1 is a rigid articulated Unitree G1 model with STL link meshes attached to the
 
 ## Setup
 
-G1 downloads automatically on first use. To prefetch and save the path:
+G1 downloads automatically on first use from `https://huggingface.co/abcamiletto/body-models`.
+The Hugging Face repo records the original GR00T-WholeBodyControl / LeRobot provenance. To prefetch
+and save the path:
 
 ```bash
 # Download the Unitree G1 XML and link meshes.

docs/models/garment-measurements.md

@@ -4,8 +4,9 @@ GarmentMeasurements is a PCA body model with an FBX-derived skeleton and skinnin
 
 ## Setup
 
-GarmentMeasurements downloads its preprocessed asset from
-`https://huggingface.co/datasets/abcamiletto/body-models-assets` on first use. To prefetch and save the path:
+GarmentMeasurements downloads its preprocessed assets from
+`https://huggingface.co/abcamiletto/body-models` on first use. The Hugging Face repo records
+the original SOMA-X Apache 2.0 provenance for the source asset. To prefetch and save the path:
 
 ```bash
 # Download the preprocessed GarmentMeasurements body-model asset.

docs/models/mhr.md

@@ -4,13 +4,17 @@ MHR is an expressive full-body model with neural pose correctives.
 
 ## Setup
 
-MHR downloads automatically on first use. To prefetch and save the path:
+MHR downloads from the public [`abcamiletto/body-models`](https://huggingface.co/abcamiletto/body-models) Hugging Face repository on first use. The hosted package keeps the original MHR checkpoint for the default LOD 1 path and adds preprocessed FBX-derived mesh assets for LODs 0 through 6.
+
+To prefetch and save the path:
 
 ```bash
 # Download the MHR assets and store their path in the body-models config.
 body-models download mhr
 ```
 
+The original MHR license is included with the hosted assets.
+
 ## API
 
 ::: body_models.bodies.mhr.numpy.MHR

docs/models/myofullbody.md

@@ -4,7 +4,8 @@ MyoFullBody is a MuJoCo-derived musculoskeletal full-body model from `amathislab
 
 ## Setup
 
-MyoFullBody downloads automatically on first use. To prefetch and save the path:
+MyoFullBody downloads automatically on first use from `https://huggingface.co/abcamiletto/body-models`.
+The Hugging Face repo records the original MuscleMimic Apache 2.0 provenance. To prefetch and save the path:
 
 ```bash
 # Download the MyoFullBody MJCF and referenced mesh assets.

docs/models/smpl-humanoid.md

@@ -0,0 +1,18 @@
+# SmplHumanoid
+
+SmplHumanoid is a rigid articulated humanoid model loaded from SMPL-compatible MJCF XML variants.
+
+## Setup
+
+SmplHumanoid downloads its XML assets from the public [`abcamiletto/body-models`](https://huggingface.co/abcamiletto/body-models) Hugging Face repository. To prefetch and save the hosted path:
+
+```bash
+# Download the SmplHumanoid MJCF XML assets.
+body-models download smpl-humanoid
+```
+
+The hosted folder includes license/provenance notes for the XML variants.
+
+## API
+
+::: body_models.robots.smpl_humanoid.numpy.SmplHumanoid

docs/models/soma.md

@@ -4,7 +4,8 @@ SOMA provides a native implementation for SOMA-X assets with identity, pose, and
 
 ## Setup
 
-SOMA downloads automatically on first use. To prefetch and save the path:
+SOMA downloads automatically on first use from `https://huggingface.co/abcamiletto/body-models`.
+The Hugging Face repo records the original SOMA-X Apache 2.0 provenance. To prefetch and save the path:
 
 ```bash
 # Download the SOMA-X assets used by the native SOMA implementation.