my_hhtools

中文说明

Personal open-source fork of jaggerShen/human-humanoid-tools. Repository: github.com/qianxvde/my_hhtools.

It keeps the core humanoid motion retargeting workflow and adds adapters for the companion my_mjlab fall-recovery training stack. The Python CLI package name remains hhtools (uv run hhtools web, etc.).

What Changed

• Added motion clipping utilities for selecting useful segments before training.
• Added data conversion utilities for exporting training-ready MJLab/robot motion files from CSV, PKL, BVH, and related motion sources.
• Added Humanoid-oriented robot adapters and schemas used by our training framework.
• Kept the web and CLI workflow for motion preview, robot retargeting, and batch dataset inspection.

Install

uv sync --extra all

If uv is not installed, see https://docs.astral.sh/uv/.

Common Commands

uv run hhtools web
uv run hhtools convert --help
uv run hhtools robot --help

The web app runs at http://127.0.0.1:8009 by default.

Notes

• SMPL/SMPL-X body model weights are not redistributed. Place your licensed model files under configs/body_models/ when needed.
• Full third-party motion datasets are not redistributed. Use this project to convert or inspect locally obtained data.
• Converted MJLab NPZ files can be consumed by the companion my_mjlab training repository.

License

Code is released under the repository license. Please also follow the licenses of upstream datasets, body models, and the original human-humanoid-tools project.