Metadata-Version: 2.4
Name: body-models
Version: 0.25.1
Summary: Parametric and articulated body models for NumPy, PyTorch, and JAX with optional Warp acceleration
Author: Andrea Boscolo Camiletto
Author-email: Andrea Boscolo Camiletto <abcamiletto@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Dist: huggingface-hub>=1.11.0
Requires-Dist: jaxtyping>=0.2.28
Requires-Dist: nanomanifold>=0.8.0
Requires-Dist: numpy>=2.0.0
Requires-Dist: platformdirs>=4.6
Requires-Dist: ptloader==0.3.0
Requires-Dist: scipy>=1.13.0
Requires-Dist: trimesh>=4.0.0
Requires-Dist: typer>=0.9.0
Requires-Dist: jax>=0.4.33 ; extra == 'jax'
Requires-Dist: pyfqmr>=0.3.0 ; extra == 'simplify'
Requires-Dist: torch>=2.5.0 ; extra == 'torch'
Requires-Dist: warp-lang>=1.12.0 ; extra == 'warp'
Requires-Python: >=3.11
Provides-Extra: jax
Provides-Extra: simplify
Provides-Extra: torch
Provides-Extra: warp
Description-Content-Type: text/markdown

# body-models

Parametric human models for NumPy, PyTorch, and JAX behind a consistent Python
API.

## Installation

`body-models` requires Python 3.11 or newer. NumPy support is included by
default. Install an extra for PyTorch or JAX.

```bash
pip install body-models
pip install "body-models[torch]"
pip install "body-models[jax]"
```

## Example

```python
from body_models.gnm.numpy import GNM

model = GNM()
params = model.get_rest_pose(batch_dims=(1,))

vertices = model.forward_vertices(**params)
skeleton = model.forward_skeleton(**params)
```

Public assets such as GNM Head download on first use. Models with restricted
assets require registration with their upstream project.

## Models

| Category | Models |
| --- | --- |
| Bodies | SMPL, SMPL-H, SMPL-X, ANNY, MHR, SOMA |
| Heads | FLAME, GNM Head |
| Hands | MANO |
| Anatomy | SKEL |
| Measurements | GarmentMeasurements |

The [documentation](https://abcamiletto.github.io/body-models/) covers model
setup, parameters, supported runtimes, and the shared API.

## License

The library is licensed under Apache 2.0. Model assets retain their upstream
licenses; see the documentation for each model.
