Metadata-Version: 2.4
Name: keypoints2body
Version: 0.1.0
Summary: SMPL/SMPLH/SMPLX optimization library for single frames and sequences
Author: keypoints2body contributors
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: numpy
Requires-Dist: torch
Requires-Dist: smplx
Requires-Dist: h5py
Requires-Dist: tqdm
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=7; extra == "docs"
Requires-Dist: furo>=2024.8.6; extra == "docs"
Requires-Dist: sphinxcontrib-mermaid>=0.9; extra == "docs"
Provides-Extra: eval
Provides-Extra: render

![keypoints2body header](docs/assets/header.svg)

# keypoints2body

`keypoints2body` is a Python library for optimizing SMPL-family body model parameters
from 3D joints for both single frames and motion sequences.

## Install

```bash
pip install -e .
```

## Quick usage

```python
import numpy as np
from keypoints2body import optimize_params_frame

joints = np.zeros((22, 3), dtype=np.float32)
result = optimize_params_frame(joints, joint_layout="AMASS")
```

## Documentation

Full documentation lives under [`docs/`](docs/) and is intended for Sphinx.

Suggested starting points:

- [Getting started](docs/getting_started.rst)
- [Library usage](docs/usage.rst)
- [CLI reference](docs/cli.rst)
- [Architecture](docs/architecture.rst)
- [API reference](docs/api.rst)
- [Contributor guide](docs/contributing.rst)

## CLI

```bash
keypoints2body-fit-frame --help
keypoints2body-fit-seq --help
keypoints2body-eval --help
```

Project script:

```bash
python smpl_fit.py --help
```
