CoolFace
Apppublic

wkddbwld/SAM3D

sourceHugging Facemitupdated 10mo agoView on Hugging Face
0likes
App README

๐ŸŽจ Text to 3D โ€“ MCP Server

Generate and edit 3D models from text prompts using Gemini + Meta SAM-3D.

๐ŸŽฌ Demo: [YouTube Link] ๐Ÿ“ฑ Post: [X/LinkedIn Link]

๐Ÿ’ก Use Cases

This tool enables rapid 3D asset creation through natural language:

  • โ€”Game Developers โ€“ Quickly prototype 3D assets by describing them ("a medieval sword", "a sci-fi helmet")
  • โ€”Designers & Artists โ€“ Generate concept models and iterate with text edits ("make it larger", "change color to gold")
  • โ€”E-commerce โ€“ Create product mockups from descriptions for visualization
  • โ€”Education โ€“ Generate 3D models for teaching (anatomy, architecture, objects)
  • โ€”AI Agents โ€“ Claude/Cursor can autonomously create 3D assets as part of larger workflows via MCP

๐Ÿš€ Future Scope

  • โ€”Multi-object scene generation
  • โ€”Style transfer for 3D models
  • โ€”Animation support
  • โ€”Direct 3D file editing without regeneration
  • โ€”Integration with game engines (Unity/Unreal)

๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”      MCP Protocol      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Claude Desktop โ”‚ โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ โ”‚   Gradio MCP Server โ”‚
โ”‚  Cursor / Cline โ”‚                        โ”‚   (HF Space)        โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                                      โ”‚
                        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                        โ–ผ                             โ–ผ                             โ–ผ
                 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                 โ”‚   Gemini    โ”‚              โ”‚   Gemini    โ”‚              โ”‚   SAM-3D    โ”‚
                 โ”‚  Generate   โ”‚โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚    Edit     โ”‚โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚   (Modal)   โ”‚
                 โ”‚   Image     โ”‚              โ”‚  / Remove   โ”‚              โ”‚  3D Recon   โ”‚
                 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Flow: Text โ†’ Image โ†’ Remove BG โ†’ Grayscale Mask โ†’ SAM-3D โ†’ 3D Model (GLB/PLY)

๐Ÿ”Œ MCP Tools

ToolDescription
generate_3dText prompt โ†’ 3D model
edit_3dEdit existing model with text

Connect from Claude Desktop

json
{
  "mcpServers": {
    "text-to-3d": {
      "command": "npx",
      "args": ["mcp-remote", "https://MCP-1st-Birthday-text-to-3d-SAM3D.hf.space/gradio_api/mcp/sse"]
    }
  }
}

๐Ÿ› ๏ธ Tech Stack

ComponentPurpose
Gemini 2.5 FlashImage generation
Gemini 3 ProBackground removal & editing
SAM-3D (Meta)3D reconstruction
ModalServerless GPU
GradioUI + MCP server

๐Ÿ“ฆ Outputs

  • โ€”GLB โ€“ 3D mesh
  • โ€”PLY โ€“ Gaussian splat

Built for [MCP 1st Birthday Hackathon](https://huggingface.co/MCP-1st-Birthday) ๐ŸŽ‚