Momentum provides foundational algorithms for human kinematic motion and numerical optimization solvers to apply human motion in various applications.

Pre-built binaries are available for Windows, macOS, and Linux:

Install full conda/pixi packages -- recommended

# Install full python package from pixi, including modules with cpp torch dependencies
pixi add pymomentum

# Install full python package from conda, including modules with cpp torch dependencies
conda install -c conda-forge pymomentum

# Install cpp momentum package from pixi, including modules with cpp torch dependencies
pixi add momentum-cpp

# Install cpp momentum package from conda, including modules with cpp torch dependencies
conda install -c conda-forge momentum-cpp

Install PyPI wheels -- these are experimental ⚠️

# Install the NumPy/native core without PyTorch
pip install pymomentum-core

# Install core package with optional visualization helpers
pip install "pymomentum-core[viser,rerun]"

# Add diff_geometry, Torch helpers, and differentiable solvers for CPU PyTorch
pip install pymomentum-cpu

# Install full package including diff_geometry and differentiable solver modules, linked against CUDA PyTorch
pip install "torch>=2.8,<2.9" --index-url https://download.pytorch.org/whl/cu129
pip install pymomentum-gpu

The same layered packages are available from conda-forge. pymomentum remains a compatibility package that installs the CPU or GPU stack selected by the solver.

The pymomentum-core package owns the NumPy/native modules geometry, solver2, marker_tracking, axel, camera, and renderer. It does not install PyTorch. pymomentum-cpu and pymomentum-gpu are mutually exclusive add-ons: each installs the Torch helpers plus diff_geometry and solver, and depends on a compatible pymomentum-core release.

⚠️ PyPI support is experimental. For the most stable experience, we recommend using Conda or Pixi.

📦 Browse packages: conda-forge • prefix.dev • PyPI

git clone https://github.com/facebookresearch/momentum
cd momentum
pixi run build      # Builds C++ library and Python bindings
pixi run test       # Runs tests
pixi run hello_world  # Runs example

For detailed instructions, see the comprehensive guides on our website:

• 📘 Python Getting Started - Installation, building from source, troubleshooting
• 📗 C++ Getting Started - Full build instructions, FBX support, examples

Visit our documentation website for comprehensive guides, examples, and API references:

• 🐍 Python API Reference - Complete Python API documentation
• ⚙️ C++ API Reference - Complete C++ API documentation

Check our contributing guide to learn about how to contribute to the project.

Momentum is licensed under the MIT License. A copy of the license can be found here.