{"id":24601,"library":"smplx","title":"SMPL-X Body Model","description":"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.","status":"active","version":"0.1.28","language":"python","source_language":"en","source_url":"https://github.com/vchoutas/smplx","tags":["body-model","SMPL-X","3D-human","pytorch","mesh"],"install":[{"cmd":"pip install smplx","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core dependency for tensor operations","package":"torch","optional":false},{"reason":"Array operations for data conversion","package":"numpy","optional":false}],"imports":[{"note":"Deprecated in favour of top-level import","wrong":"from smplx.smpl import SMPL","symbol":"SMPL","correct":"from smplx import SMPL"},{"note":"Deprecated internal module","wrong":"from smplx.smplx import SMPLX","symbol":"SMPLX","correct":"from smplx import SMPLX"},{"note":"","wrong":"","symbol":"SMPLH","correct":"from smplx import SMPLH"}],"quickstart":{"code":"import torch\nfrom smplx import SMPLX\n\nmodel = SMPLX(model_path='models/', gender='neutral')\nbody_pose = torch.zeros(1, 63)\nbetas = torch.zeros(1, 10)\noutput = model(body_pose=body_pose, betas=betas)\nprint(output.vertices.shape)","lang":"python","description":"Initialize the SMPL-X model and run a forward pass with placeholder poses and shape parameters."},"warnings":[{"fix":"Change import to 'from smplx import SMPLX'.","message":"Importing from 'smplx.smplx' or 'smplx.smpl' is deprecated. Use top-level 'from smplx import SMPLX'.","severity":"deprecated","affected_versions":">=0.1.0"},{"fix":"Ensure the directory contains the correct .npz model files (download from SMPL-X website).","message":"The model expects paths to the model files (e.g., 'SMPLX_NEUTRAL.npz') not just directory. Missing files cause cryptic errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Use model_path='/path/to/models/' instead of model_folder.","message":"Model path argument changed from 'model_folder' to 'model_path' in v0.1.20. Old code will break.","severity":"breaking","affected_versions":">=0.1.20"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Download model files from https://smpl-x.is.tue.mpg.de/ and place them in the correct directory.","cause":"Model files not present in the specified path or wrong model_path.","error":"FileNotFoundError: [Errno 2] No such file or directory: 'models/SMPLX_NEUTRAL.npz'"},{"fix":"Use 'from smplx import SMPLX' instead of 'from smplx.smplx import SMPLX'.","cause":"Using deprecated import path after update.","error":"ModuleNotFoundError: No module named 'smplx.smplx'"},{"fix":"Use 'model_path' instead of 'model_folder'.","cause":"Old argument 'model_folder' not recognized in current version.","error":"TypeError: __init__() got an unexpected keyword argument 'model_folder'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}