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

Nodes

Load SAM 3D Body Model - Load model from HuggingFace (facebook/sam-3d-body-dinov3) or local checkpoint
Process Image - Reconstruct 3D mesh from image with optional mask/detection (full/body/hand modes)
Process Image (Advanced) - Full control over detection, segmentation, and FOV estimation
Visualize Mesh - Render 3D mesh overlay on image
Export Mesh - Save mesh as OBJ/PLY file
Get Mesh Info - Display mesh statistics

License

This project uses a dual-license structure:

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)

Credits

SAM 3D Body by Meta AI (paper)

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