Momentum
Momentum provides foundational algorithms for human kinematic motion and numerical optimization solvers to apply human motion in various applications.
Quick Start
Installation
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 core package with NumPy/SciPy and PyTorch dependencies, but no Torch C++ extension modules
pip install pymomentum-core
# Install core package with optional visualization helpers
pip install "pymomentum-core[viser,rerun]"
# Install full package including diff_geometry and differentiable solver modules, linked against 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
Conda/Pixi currently publish the full PyMomentum package. Use the PyPI core package (since release v0.1.111) when you need a Python install without the Torch C++ extension dependency.
Install exactly one PyPI package for a given environment. The pymomentum-core package includes the NumPy/SciPy modules geometry, solver2, marker_tracking, axel, camera, and renderer, plus the torch-backed Python helper modules torch. The pymomentum-cpu and pymomentum-gpu packages provide differentiable optimization modules diff_geometry and solver, but they must match a supported PyTorch C++ ABI and therefore have stricter PyTorch version constraints.
⚠️ PyPI support is experimental. For the most stable experience, we recommend using Conda or Pixi.
📦 Browse packages: conda-forge • prefix.dev • PyPI
Building from Source
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
📖 Documentation
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
Contributing
Check our contributing guide to learn about how to contribute to the project.
License
Momentum is licensed under the MIT License. A copy of the license can be found here.
1 maintainer
Release files for pymomentum-cpu 0.1.114.post0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| pymomentum_cpu-0.1.114.post0-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
| pymomentum_cpu-0.1.114.post0-cp313-cp313-manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ x86-64 | Details |
| pymomentum_cpu-0.1.114.post0-cp313-cp313-macosx_14_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 14.0+ ARM64 | Details |
| pymomentum_cpu-0.1.114.post0-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| pymomentum_cpu-0.1.114.post0-cp312-cp312-manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.28+ x86-64 | Details |
| pymomentum_cpu-0.1.114.post0-cp312-cp312-macosx_14_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 14.0+ ARM64 | Details |
Total release size: 324.4 MB
Release files / pymomentum_cpu-0.1.114.post0-cp313-cp313-win_amd64.whl
| Download URL | pymomentum_cpu-0.1.114.post0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 92.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9d26fe8899b84cefd564643507148c57ff14799118c8347a057275b4b3b5690d
|
|
BLAKE2b-256 checksum How to use checksums |
f4fb5d3f2d77286e5cdf6fea76aa07221c00f69611b15264fd00713adc909bff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 16, 2026.
Transparency logRelease files / pymomentum_cpu-0.1.114.post0-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | pymomentum_cpu-0.1.114.post0-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 43.8 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
59b0ceaeb28b21ef393e55194fcd0d3ce34ddfbf0ab811d57113e2fddbe19c9b
|
|
BLAKE2b-256 checksum How to use checksums |
2f321f883da419dc9cd96fbcfe2be0a5978b72920cf604ffa5b97fd44533e184
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 16, 2026.
Transparency logRelease files / pymomentum_cpu-0.1.114.post0-cp313-cp313-macosx_14_0_arm64.whl
| Download URL | pymomentum_cpu-0.1.114.post0-cp313-cp313-macosx_14_0_arm64.whl |
|---|---|
| Size | 26.1 MB |
| Tags | CPython 3.13 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f733201c80063129fbbd3dbacdd21d4da0b3ea991198cbb67fd5b473cb9628af
|
|
BLAKE2b-256 checksum How to use checksums |
193324b70511d21722b1f680051c241a5807623bcf7ea66c2af2505290f55bd7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 16, 2026.
Transparency logRelease files / pymomentum_cpu-0.1.114.post0-cp312-cp312-win_amd64.whl
| Download URL | pymomentum_cpu-0.1.114.post0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 92.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
dbd57774c6a52c642d4dd407d638c56a266e25bfc5c79c3e55e5233aac5a5fbf
|
|
BLAKE2b-256 checksum How to use checksums |
dbab30bddd058180ca1385cb090bea59064724b9eecb7874e92b2e7bd2e00689
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 16, 2026.
Transparency logRelease files / pymomentum_cpu-0.1.114.post0-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | pymomentum_cpu-0.1.114.post0-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 43.8 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
661b013f279128e0abae09595731a314cabc3ff191ec0539d4a7d42100e4d81e
|
|
BLAKE2b-256 checksum How to use checksums |
f6d52494d6b084f26b6e0470274ca5e36cbb33b6abbc499faaf0160deb4ddfff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 16, 2026.
Transparency logRelease files / pymomentum_cpu-0.1.114.post0-cp312-cp312-macosx_14_0_arm64.whl
| Download URL | pymomentum_cpu-0.1.114.post0-cp312-cp312-macosx_14_0_arm64.whl |
|---|---|
| Size | 26.1 MB |
| Tags | CPython 3.12 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
aa2dacb8d361f6fd0517880978f8a13f76f7d9c4a0fd8b8d330e8e252d17d106
|
|
BLAKE2b-256 checksum How to use checksums |
c362614c3b86de07a281ee8ed81fb66332b79e4da70bfe5597b2cb006d72fc9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 16, 2026.
Transparency log
