README.md

metadata

title: SAM 3D Objects Gradio
emoji: 🧊
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
suggested_hardware: zero-a10g
license: other
short_description: Object-centric 3D reconstruction with Meta SAM 3D Objects

SAM 3D Objects Gradio

This Space wraps Meta's facebook/sam-3d-objects model for object-centric 3D reconstruction.

Inputs:

• An RGB image.
• A binary mask image for the object to reconstruct. White pixels are treated as the object.
• A seed.

Output:

• A Gaussian splat PLY file.

Operational notes:

• The official setup requires a Linux NVIDIA GPU with at least 32 GB VRAM.
• This Space is configured to try Hugging Face ZeroGPU first.
• The model checkpoints are gated. The Space needs an HF_TOKEN secret that has access to facebook/sam-3d-objects.
• If the Space starts on CPU or a small GPU, the app will show diagnostics instead of failing silently.

References:

• https://github.com/facebookresearch/sam-3d-objects
• https://huggingface.co/facebook/sam-3d-objects
• https://ai.meta.com/blog/sam-3d/