How facebookresearch/mhr works
MHR is a parametric human-rig package: callers provide identity, pose, and expression parameters and receive mesh vertices and skeleton state. Supporting branches convert between MHR and SMPL-family models, provide mesh utilities, and offer a local web viewer. The model-loading and inference path is shown in sampled source; conversion and viewer internals are only partially sampled, so uncertain connections are omitted or marked unverified.
Main entry points: conversion.py SMPL conversion · mhr.py MHR inference · server.py Viewer backend · io.py Asset loading
Components 19
MHR model
- Model assets
- Asset loading
mhr/io.py - MHR inference
mhr/mhr.py - Pose correctives
mhr/mhr.py - Sparse operations
mhr/utils.py - Expression mapping
mhr/face_expression.py - Asset download
mhr/download_assets.py
Model conversion
- SMPL conversion
tools/mhr_smpl_conversion/conversion.py - PyMomentum fitting
tools/mhr_smpl_conversion/pymomentum_fitting.py - PyTorch fitting
tools/mhr_smpl_conversion/pytorch_fitting.py - Conversion mappings
tools/mhr_smpl_conversion/file_assets.py
Mesh tools
- LOD conversion
tools/mhr_LOD_conversion - Segmentation
tools/mhr_create_segmentation/example.py - Visualization notebook
tools/mhr_visualization
Web viewer
- Viewer backend
web-viewer/server.py - Three.js interface
web-viewer/static/app.js - Mesh exporters
web-viewer/exporters.py
Other components
- Python caller
- Viewer user
Connections 18
- Python caller → MHR inference: provides parameters
README.md - Asset loading → Model assets: loads model data
mhr/io.py - MHR inference → Asset loading: loads assets
mhr/mhr.py - MHR inference → Pose correctives: applies correctives
mhr/mhr.py - Pose correctives → Sparse operations: uses sparse layer
mhr/mhr.py - Python caller → Asset download: downloads assets
README.md - SMPL conversion → MHR inference: uses MHR model
tools/mhr_smpl_conversion/conversion.py - SMPL conversion → PyMomentum fitting: selects fitting
tools/mhr_smpl_conversion/conversion.py - SMPL conversion → PyTorch fitting: selects fitting
tools/mhr_smpl_conversion/conversion.py - SMPL conversion → Conversion mappings: uses mappings
- Python caller → SMPL conversion: requests conversion
README.md - Python caller → LOD conversion: converts LOD
README.md - Python caller → Segmentation: creates segments
tools/mhr_create_segmentation/example.py - Segmentation → MHR inference: loads model
tools/mhr_create_segmentation/example.py - Python caller → Visualization notebook: opens visualization
README.md - Viewer user → Viewer backend: uses viewer
- Three.js interface → Viewer backend: sends controls
- Viewer backend → Mesh exporters: uses exporters
web-viewer/server.py