Spaces:
Running
Running
| 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](https://huggingface.co/spaces/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): | |
| ```bash | |
| 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](https://huggingface.co/facebook/sam-3d-objects), | |
| [Meta source](https://github.com/facebookresearch/sam-3d-objects), **SAM License**. | |
| - Segmentation: [facebook/sam3](https://huggingface.co/facebook/sam3); its own license applies. | |
| - Public inference: [HaiderCG/sam3d-lab](https://huggingface.co/spaces/HaiderCG/sam3d-lab). | |
| - Bus test image: [Gradio repository test fixture](https://github.com/gradio-app/gradio/blob/main/test/test_files/bus.png). | |
| - 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. | |