README.md

metadata

title: SAM 3D Objects Studio
emoji: 🧊
colorFrom: green
colorTo: blue
sdk: static
app_file: index.html
short_description: Select an object in a photo and reconstruct it in 3D
models:
  - facebook/sam-3d-objects
  - facebook/sam3
tags:
  - image-to-3d
  - 3d-modeling
  - sam3d
  - static
license: mit
pinned: false
hf_oauth: true
hf_oauth_expiration_minutes: 480

SAM 3D Objects Studio

A free, browser-based demo for Meta's SAM 3D Objects: upload a photo, name one object, and inspect/download the reconstructed vertex-colored GLB mesh.

Architecture and limits

This is a static frontend, not a standalone model deployment. Live inference uses the public HaiderCG/sam3d-lab Gradio API, running SAM 3 segmentation → SAM 3D Objects reconstruction. The frontend uses the official @gradio/client queue protocol and @google/model-viewer for interactive GLB rendering.

• No paid hardware, API key, or embedded token is required by this frontend.
• Optional Sign in with Hugging Face uses the official OAuth flow (profile only, no repository write access). The short-lived token stays in this browser tab's session storage and is used only to authenticate requests to Hugging Face / the named Gradio backend. It is never bundled or sent to this static Space as a stored secret. Sign out clears it.
• Shared backend availability and Hugging Face ZeroGPU quotas apply. Requests can queue or fail when capacity/quota is exhausted. No automatic backend switching.
• Uploaded images and prompts go directly to the named third-party backend. Do not upload confidential or personal images. This frontend has no analytics and does not persist uploads. The backend's own data policies still apply.
• Generation reconstructs the highest-scoring matching instance, not every object. Use short English object names such as bus, chair, or coffee mug.
• Backend seed is 42. Mesh postprocessing, texture baking, and layout postprocessing are disabled upstream; the output uses vertex colors rather than a baked texture map. Hidden surfaces are model estimates, not measurements.
• The bus example's saved GLB is an actual SAM 3D Objects API result, clearly labeled as a saved example. It remains inspectable without consuming GPU quota.

Using the demo

1. Choose a PNG, JPEG, or WebP image (up to 20 MB / 20 megapixels), or load the bus example.
2. Name the object to reconstruct.
3. Select Generate 3D. A cold request can take a few minutes plus queue time.
4. Drag to orbit, scroll/pinch to zoom, and download the GLB or mask preview.

The Saved result button shows the bundled, verified bus reconstruction; Generate 3D always sends a new inference request (it does not serve the cache). Cancellation stops listening and cancels queued work where supported; work that already started may continue on the shared GPU.

Build / develop

The Space serves a prebuilt release. Download source-code.zip from the Files tab for the complete editable Vite project. Extract it before the commands below.

Node.js 22.12+ (Node 24 recommended):

npm ci
npm test
npm run build
npm run dev

Run npm run build, then upload the contents of dist/ to this repository's root, retaining this README. The Space serves index.html without paid build/runtime hardware. Do not put access tokens in JavaScript, static Space variables, or this repository.

Credits and licenses

• Model: facebook/sam-3d-objects, Meta source, SAM License.
• Segmentation: facebook/sam3; its own license applies.
• Public inference: HaiderCG/sam3d-lab.
• Bus test image: Gradio repository test fixture.
• Application source is MIT licensed. This does not relicense model weights, the example image, or generated outputs. Review the upstream model terms for use.

An independent community demo; not an official Meta application.