---
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/