ComfyUI-MotionCapture

Installation

Three options, in order of speed → reliability:

1. ComfyUI Manager (recommended) — search for MotionCapture in the Manager and click Install from the highest version displayed. If that doesn't work, try nightly.
2. Manager via Git URL — in ComfyUI Manager: "Install via Git URL" with https://github.com/PozzettiAndrea/ComfyUI-MotionCapture.git.
3. Manual (most reliable):

   cd ComfyUI/custom_nodes
   git clone https://github.com/PozzettiAndrea/ComfyUI-MotionCapture.git
   cd ComfyUI-MotionCapture
   pip install -r requirements.txt --upgrade
   python install.py

Please report any problems you hit during installation or use of my nodes — open a Discussion or Issue. Very grateful for your help! 🙏

View Live Test Gallery →

A ComfyUI custom node package for GVHMR-based 3D human motion capture from video. Extract SMPL parameters and 3D skeletal motion using state-of-the-art pose estimation.

https://github.com/user-attachments/assets/17638ca5-8139-40ca-b215-0d7dabf0ea73

https://github.com/user-attachments/assets/ba7a7797-713d-4750-9210-ff07bcc6bb01

Credits

GVHMR

@inproceedings{qiu2024gvhmr,
  title={World-Grounded Human Motion Recovery via Gravity-View Coordinates},
  author={Qiu, Zehong and Wang, Qingshan and Peng, Zhenbo and others},
  booktitle={SIGGRAPH Asia},
  year={2024}
}

Components

• ViTPose: https://github.com/ViTAE-Transformer/ViTPose
• HMR2: https://github.com/shubham-goel/4D-Humans
• SMPL: https://smpl.is.tue.mpg.de/
• SMPL-X: https://smpl-x.is.tue.mpg.de/

License

This package vendors GVHMR code which has its own license. Please check the original GVHMR repository for licensing terms.

SMPL and SMPL-X body models require separate licenses from their respective providers.