Extensions/ComfyUI-SAM3DBody
ComfyUI Extension

ComfyUI-SAM3DBody

SAM 3D Body integration for ComfyUI - Robust full-body human mesh recovery from single images. Reconstruct 3D human meshes with pose, shape, and hand details. First…

By PozzettiAndrea·Created 9 months ago·Updated 2 months ago· 321
PozzettiAndrea/ComfyUI-SAM3DBody
Nodes15
On cloudLocal install
CategorySAM3DBody, SAM3DBody/skeleton
Stars321
Updated2 months ago

Nodes (15)

(Down)Load SAM 3D Body Model

The entry point for turning a photo into a 3D human mesh

SAM3DBody
SAM 3D Body: Add Mesh to Skeleton

Rebuild a mesh from a saved pose without re-running detection

SAM3DBody/skeleton
SAM 3D Body: Export FBX

Get the rigged version out, not just the raw mesh

SAM3DBody/export
SAM 3D Body: Export Mesh

Save your SAM3DBody mesh as an STL, no rig attached

SAM3DBody/io
SAM 3D Body: Export Multiple FBX

Batch-export rigged FBX files for a whole group photo

SAM3DBody/export
SAM 3D Body: Get Mesh Info

A quick text readout of what's actually in your mesh

SAM3DBody/utilities
SAM 3D Body: Load Mesh

Reload a saved mesh without burning GPU time on inference again

SAM3DBody/IO
SAM 3D Body: Load Skeleton

Bring a saved pose back into your graph

SAM3DBody/skeleton
SAM 3D Body: Preview Rigged Mesh

Check your rigged FBX inside ComfyUI, no Blender needed

SAM3DBody/visualization
SAM 3D Body: Process Image

Turn one photo of a person into a posed 3D mesh

SAM3DBody/processing
SAM 3D Body: Process Image (Advanced)

The SAM3DBody processor with the detector/segmentor swapped in your control

SAM3DBody/advanced
SAM 3D Body Process Multiple

3D mesh recovery for more than one person in the frame

SAM3DBody/processing
SAM 3D Body: Save Skeleton

Save just the pose, without the weight of a full mesh

SAM3DBody/skeleton
SAM 3D Body: Select Mesh File

Pick a saved mesh file and pass its path along, nothing more

SAM3DBody/IO
SAM 3D Body: Visualize Mesh

Render your SAM3DBody mesh back over the source photo

SAM3DBody/visualization
Readme

[!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): 
    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 or Issue. 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

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

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

body

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

    • 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

    • 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 for complete license information and 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 on GitHub.

Join the Comfy3D Discord for help, updates, and chat about 3D workflows in ComfyUI.

Credits

SAM 3D Body by Meta AI (paper)

Blender installation code adapted from ComfyUI-UniRig (MIT License)