smplx

library0.1.28pypypi✓ verified 84d ago

PyTorch module for loading the SMPL-X body model, a unified model of body, face, and hands. Current version 0.1.28, with sporadic releases.

ai-ml data

pip install smplx

package ↗homepage ↗

INSTALL

IMPORT

SIG · SMPLX

smplx

ai-mlpythonv0.1.28

Install

67.4s avg

Import

5698ms

Disk

4813MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.28 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 76.9s

py 3.11

✕ build_error

✓ 69.2s

py 3.12

✕ build_error

✓ 65.5s

py 3.13

✕ build_error

✓ 57.8s

py 3.9

✕ build_error

✕ timeout

4813MB installed

● package 4813MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SMPL

✓ from smplx import SMPL

✗ from smplx.smpl import SMPL

Deprecated in favour of top-level import

SMPLX

✓ from smplx import SMPLX

✗ from smplx.smplx import SMPLX

Deprecated internal module

SMPLH

✓ from smplx import SMPLH

Initialize the SMPL-X model and run a forward pass with placeholder poses and shape parameters.

import torch from smplx import SMPLX model = SMPLX(model_path='models/', gender='neutral') body_pose = torch.zeros(1, 63) betas = torch.zeros(1, 10) output = model(body_pose=body_pose, betas=betas) print(output.vertices.shape)

Debug

Known issues

deprecatedImporting from 'smplx.smplx' or 'smplx.smpl' is deprecated. Use top-level 'from smplx import SMPLX'.

fix

Change import to 'from smplx import SMPLX'.

affects: >=0.1.0

gotchaThe model expects paths to the model files (e.g., 'SMPLX_NEUTRAL.npz') not just directory. Missing files cause cryptic errors.

fix

Ensure the directory contains the correct .npz model files (download from SMPL-X website).

affects: all

breakingModel path argument changed from 'model_folder' to 'model_path' in v0.1.20. Old code will break.

fix

Use model_path='/path/to/models/' instead of model_folder.

affects: >=0.1.20

Errors

Common errors & fixes

FileNotFoundError: [Errno 2] No such file or directory: 'models/SMPLX_NEUTRAL.npz'

Model files not present in the specified path or wrong model_path.

fix

Download model files from https://smpl-x.is.tue.mpg.de/ and place them in the correct directory.

ModuleNotFoundError: No module named 'smplx.smplx'

Using deprecated import path after update.

fix

Use 'from smplx import SMPLX' instead of 'from smplx.smplx import SMPLX'.

TypeError: __init__() got an unexpected keyword argument 'model_folder'

Old argument 'model_folder' not recognized in current version.

fix

Use 'model_path' instead of 'model_folder'.

Upgrade

Version history

0.1.28latest on PyPI · released May 26, 2021

Audit

Dependencies

torchrequiredCore dependency for tensor operations

numpyrequiredArray operations for data conversion

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/smplx/ ↗

homepagehttp://smpl-x.is.tuebingen.mpg.de ↗