splat-explorer / README.md
ArtelTaleb's picture
Update README.md
519b54b verified
metadata
title: Splat Explorer  Image to 3D Mesh Studio
emoji: 💻
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: true
license: mit
language:
  - en
  - fr
tags:
  - 3d-reconstruction
  - image-to-3d
  - text-to-3d
  - 3d-generation
  - 3d-modeling
  - 3d-mesh
  - mesh-generation
  - glb
  - gltf
  - mesh
  - wireframe
  - topology
  - retopology
  - blender
  - zbrush
  - maya
  - game-dev
  - game-assets
  - character-modeling
  - 3d-scanning
  - photogrammetry
  - computer-vision
  - multimodal
  - gemini
  - google-ai
  - flux
  - flux-schnell
  - instant-mesh
  - qwen
  - vision-language-model
  - huggingface-inference-api
  - fastapi
  - docker
  - professional
  - multilingual
  - english
  - french
models:
  - black-forest-labs/FLUX.1-schnell
  - Qwen/Qwen2.5-VL-7B-Instruct
short_description: Image or text to 3D mesh  professional modeling tool

🐠 Splat Explorer — Image to 3D Mesh Studio

HF Space License: MIT Powered by InstantMesh Docker

Professional image-to-3D mesh generation — upload photos or describe your subject, get a production-ready GLB mesh with wireframe inspection.


🇬🇧 English

Splat Explorer converts images or text prompts into production-ready 3D meshes (GLB/GLTF) using state-of-the-art AI models. Built for 3D artists, game developers, architects, and product designers who need fast, high-quality 3D reconstruction from real-world references.

✨ Features

  • 📸 Multi-image input — upload up to 6 reference photos for accurate multi-view reconstruction
  • ✍️ Text-to-3D — generate a reference image with FLUX.1-Schnell, then convert to 3D mesh
  • 🧠 AI vision analysis — Qwen2.5-VL automatically synthesizes multi-angle descriptions for optimal 3D generation
  • 🔳 Wireframe inspector — mesh view activated by default after generation for immediate topology review
  • 📥 GLB export — production-ready mesh compatible with Blender, ZBrush, Maya, Unity, Unreal Engine
  • 🔑 Bring your own HF token — no data stored server-side

🎯 Professional Use Cases

  • Game development: rapid asset prototyping, character base meshes, prop generation
  • 3D sculpting: reference mesh for retopology in ZBrush or Blender
  • Architecture & product design: 3D model from product photos or sketches
  • VFX & animation: base mesh generation from concept art or real references
  • 3D printing: convert physical objects from photos to printable mesh

🚀 Usage

  1. Get a free HF token at huggingface.co/settings/tokens
  2. Upload 1–6 reference photos (multi-angle recommended) or enter a text prompt
  3. Click Generate — AI vision analyzes your images, then builds the 3D mesh
  4. Inspect topology in wireframe mode (activated by default)
  5. Export as GLB for use in your 3D pipeline

⚡ Pipeline

Photos (1-6) → Qwen2.5-VL (vision analysis) → FLUX.1-Schnell (if text) → InstantMesh → GLB mesh

🔐 Privacy

Your HF token is used exclusively to call HF Inference API models. No images or meshes are stored server-side beyond the current session.


🇫🇷 Français

Splat Explorer convertit des photos ou des prompts texte en maillages 3D GLB/GLTF prêts pour la production. Conçu pour les artistes 3D, développeurs de jeux, architectes et designers produit.

✨ Fonctionnalités

  • 📸 Jusqu'à 6 photos de référence pour une reconstruction multi-vues précise
  • ✍️ Texte → 3D : génération d'image via FLUX.1-Schnell puis conversion en maillage
  • 🧠 Analyse vision IA : Qwen2.5-VL synthétise les angles pour optimiser la génération 3D
  • 🔳 Inspecteur maillage : vue wireframe activée par défaut après génération
  • 📥 Export GLB compatible Blender, ZBrush, Maya, Unity, Unreal Engine
  • 🔑 Token HF personnel — aucune donnée stockée côté serveur

🚀 Utilisation

  1. Obtenez un token HF gratuit sur huggingface.co/settings/tokens
  2. Importez 1 à 6 photos de référence ou entrez un prompt texte
  3. Cliquez Generate — l'IA analyse et construit le maillage 3D
  4. Inspectez la topologie en mode wireframe (activé par défaut)
  5. Exportez en GLB pour votre pipeline 3D

🛠️ Stack

Component Technology
3D Mesh Generation InstantMesh via frogleo/Image-to-3D
Vision Analysis Qwen/Qwen2.5-VL-7B-Instruct
Text-to-Image FLUX.1-Schnell (black-forest-labs)
Backend Python + FastAPI
Wireframe Renderer Three.js + OrbitControls
Deployment Docker on HF Spaces

🔗 Perfect Workflow — Use with 8view AI Studio

⭐ Recommended combination: 8view AI Studio + Splat Explorer work exceptionally well together.

8view AI Studio generates professional orthographic topology reference sheets (front, back, side, 3/4 views) from any subject using Gemini Vision AI. Feed those reference sheets directly into Splat Explorer for highly accurate multi-view 3D reconstruction — the orthographic angles are exactly what InstantMesh needs for optimal mesh quality.

Step Tool Action
1 🎯 8view AI Studio Generate 8-view orthographic topology sheets from your subject
2 Splat Explorer (this app) Upload the 8 reference views → generate precise 3D mesh
3 🎨 Canva3D Inspect the exported GLB in the interactive 3D viewer

🔗 Related Spaces