ComfyUI Extension: ComfyUI-SAM3DBody

Authored by PozzettiAndrea

Created

Updated

246 stars

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 draft, please open a github issue if you have any problems or feature requests :)

Custom Nodes (16)

README

ComfyUI-SAM3DBody

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!

Installation

Run the installation script: python install.py

macOS Note: If you encounter build errors with xtcocotools, the install script handles this automatically. For manual installation: pip install --no-build-isolation xtcocotools

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)