README.md

---
license: other
license_name: sam-license
license_link: LICENSE
extra_gated_prompt: >-
  These weights are redistributed under Meta's SAM License, a copy of which is
  included in this repository as LICENSE. By requesting access you agree to be
  bound by it. Note in particular that the license prohibits use for military
  or warfare purposes, nuclear applications, espionage, and the development or
  use of guns or illegal weapons, and that your use must comply with applicable
  Trade Controls. Access is not available in comprehensively sanctioned
  jurisdictions.
extra_gated_fields:
  Name: text
  Affiliation: text
  Country: country
  I accept the terms of the SAM License: checkbox
  I confirm I am not located in a comprehensively sanctioned jurisdiction: checkbox
tags:
  - human-mesh-recovery
  - 3d-human-mesh-recovery
  - human-pose-estimation
  - mesh
  - libreyolo
library_name: libreyolo
pipeline_tag: image-to-3d
---

# LibreSAM3DBodyd3-mesh

A mirror of Meta's [`facebook/sam-3d-body-dinov3`](https://huggingface.co/facebook/sam-3d-body-dinov3) SAM 3D Body checkpoint, hosted
for use with the LibreYOLO `mesh` task (human body mesh recovery).

## This is a mirror, not a new model

The weights are Meta's, unmodified. Nothing here is retrained, distilled or
fine-tuned. The mirror exists so LibreYOLO's `mesh` task has a stable,
version-pinned source, and so the gate below travels with the weights.

Upstream revision mirrored: `11aaa346c7204874a1cbafe3d39a979080b2c55a`

## License: read this before requesting access

These weights are **not** MIT, and they are not covered by LibreYOLO's own MIT
license. They are redistributed under Meta's **SAM License**, included here as
[`LICENSE`](LICENSE). The SAM License permits redistribution, including
commercially, on the condition that it is passed through: anyone who
redistributes these weights further must do so under the same terms and include
a copy of the agreement.

Restrictions that survive redistribution, summarized but not replacing the text:

- No military or warfare use, nuclear applications, espionage, or guns and
  illegal weapons.
- Use must comply with applicable Trade Controls and privacy law.
- No reverse engineering or decompiling of the materials.
- Research publications using these weights must acknowledge them.
- Meta may modify the agreement, with changes effective immediately.

## Why this mirror is gated

Meta gates the upstream repository with manual approval and rejects requests
from comprehensively sanctioned jurisdictions. This mirror instead uses Hugging
Face's automatic gated-access flow: users must accept the SAM License and submit
the required identity and jurisdiction fields before access, but a repository
maintainer does not manually approve each request. It does not claim to reproduce
Meta's manual screening; users who require that process should obtain the weights
directly from the upstream repository.

## Contents

- `model.ckpt` - the upstream checkpoint, byte-identical to Meta's.
- `model_config.yaml` - the upstream model configuration.
- `LICENSE` - the SAM License, as required for redistribution.

## The MHR body model is not mirrored here

SAM 3D Body predicts into MHR (Momentum Human Rig). The MHR asset is Apache 2.0
and published ungated by Meta, so LibreYOLO fetches it directly from the
upstream release rather than holding a second copy:

    https://github.com/facebookresearch/MHR/releases/download/v1.0.1/assets.zip

LibreYOLO caches it automatically via
`libreyolo.models.sam3dbody.ensure_mhr_model()`.

## Status

The checkpoint here is the raw upstream artifact under Meta's SAM License.
LibreYOLO remains a wrapper around the separately installed upstream
implementation; this mirror includes no SAM-licensed model code and no
converted LibreYOLO-schema checkpoint.

## Citation

Please cite Meta's SAM 3D Body work when using these weights. See the upstream
model card at https://huggingface.co/facebook/sam-3d-body-dinov3.