> [!WARNING]
> Warning, uses experimental package `comfy-env` to attempt a one click isolated install. Will download and use pixi package manager.

# ComfyUI-SAM3DBody

## Installation

Three options, in order of speed → reliability:

1. **ComfyUI Manager (recommended)** — search for `SAM3DBody` in the Manager and click Install from the highest version displayed. If that doesn't work, try nightly.
2. **Manager via Git URL** — in ComfyUI Manager: "Install via Git URL" with `https://github.com/PozzettiAndrea/ComfyUI-SAM3DBody.git`.
3. **Manual (most reliable)**:
   ```bash
   cd ComfyUI/custom_nodes
   git clone https://github.com/PozzettiAndrea/ComfyUI-SAM3DBody.git
   cd ComfyUI-SAM3DBody
   pip install -r requirements.txt --upgrade
   python install.py
   ```

> **macOS**: If `xtcocotools` build errors, the install script handles it. For manual install: `pip install --no-build-isolation xtcocotools`.

> **Please report any problems** you hit during installation or use of my nodes — open a [Discussion](https://github.com/PozzettiAndrea/ComfyUI-SAM3DBody/discussions) or [Issue](https://github.com/PozzettiAndrea/ComfyUI-SAM3DBody/issues). Very grateful for your help! 🙏

---


<div align="center">
<a href="https://pozzettiandrea.github.io/ComfyUI-SAM3DBody/">
<img src="https://pozzettiandrea.github.io/ComfyUI-SAM3DBody/gallery-preview.png" alt="Workflow Test Gallery" width="800">
</a>
<br>
<b><a href="https://pozzettiandrea.github.io/ComfyUI-SAM3DBody/">View Live Test Gallery →</a></b>
</div>

ComfyUI wrapper for Meta's SAM 3D Body - single-image full-body 3D human mesh recovery.

![body](docs/body.png)


https://github.com/user-attachments/assets/5b6c0e24-5c64-4413-b4b5-e8b244c51cae

https://github.com/user-attachments/assets/8429690a-a251-458f-8b4f-aad5e723525e

https://github.com/user-attachments/assets/2906d9b5-bdf7-4593-a3ae-1f2c866d2b2e



## Multi people support

I have also added multi people support.
![body](docs/multi_people.png)

Unfortunately, there is a known issue by which people who are smaller are predicted as normal sized people, just further
https://github.com/facebookresearch/sam-3d-body/issues/69

I have tried to include some depth-supported size correction.

![body](docs/fellowship_nocorrection.png)

![body](docs/fellowship_depth_corrected.png)

Still needs some work!

## License

This project uses a **dual-license structure**. License files are located in `docs/licenses/`.

- **Wrapper Code** (ComfyUI integration): **MIT License** - See [LICENSE-MIT](docs/licenses/LICENSE-MIT)
  - This includes all nodes, UI components, installation scripts, and ComfyUI integration code
  - Copyright (c) 2025 Andrea Pozzetti

- **SAM 3D Body Library** (vendored in `sam_3d_body/`): **SAM License** - See [LICENSE-SAM](docs/licenses/LICENSE-SAM)
  - The core SAM 3D Body model and inference code
  - Copyright (c) Meta Platforms, Inc. and affiliates
  - Permissive research license allowing commercial use and derivative works

See [LICENSE](docs/licenses/LICENSE) for complete license information and [THIRD_PARTY_NOTICES](docs/licenses/THIRD_PARTY_NOTICES) for attributions.

### Using This Project

- ✅ You can freely use, modify, and distribute the wrapper code under MIT terms
- ✅ You can use SAM 3D Body for research and commercial purposes under SAM License terms
- ⚠️ When redistributing, include both LICENSE-MIT and LICENSE-SAM
- ⚠️ Acknowledge SAM 3D Body in publications (required by SAM License)

## Community

Questions or feature requests? Open a [Discussion](https://github.com/PozzettiAndrea/ComfyUI-SAM3DBody/discussions) on GitHub.

Join the [Comfy3D Discord](https://discord.gg/bcdQCUjnHE) for help, updates, and chat about 3D workflows in ComfyUI.

## Credits

[SAM 3D Body](https://github.com/facebookresearch/sam-3d-body) by Meta AI ([paper](https://ai.meta.com/research/publications/sam-3d-body-robust-full-body-human-mesh-recovery/))

Blender installation code adapted from [ComfyUI-UniRig](https://github.com/VAST-AI-Research/UniRig) (MIT License)