sharaborin/AIEXX_GENAI_IMAGE_TO_3D

<div align="center">

<table> <tr> <td align="center">

   █████╗ ██╗███████╗██╗  ██╗██╗  ██╗
  ██╔══██╗██║██╔════╝╚██╗██╔╝╚██╗██╔╝
  ███████║██║█████╗   ╚███╔╝  ╚███╔╝
  ██╔══██║██║██╔══╝   ██╔██╗  ██╔██╗
  ██║  ██║██║███████╗██╔╝ ██╗██╔╝ ██╗
  ╚═╝  ╚═╝╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝

</td> </tr> </table>

AIEXX GenAI Image to 3D

🚀 Enterprise-Grade AI-Powered 3D Model Generation System

Transform Text & Images into Production-Ready 3D Assets in Seconds

    

   

  

[🚀 Quick Start](#-quick-start) • [📖 Documentation](#-documentation) • [🎨 Workflows](#-workflows) • [⚙️ Tech Stack](#%EF%B8%8F-technology-stack) • [📊 Performance](#-performance-benchmarks) • [🤝 Contributing](#-contributing)

</div>

🌟 Overview

AIEXX GenAI Image to 3D is a professional, GPU-accelerated AI system for generating high-quality 3D models from text prompts or 2D images. Built on cutting-edge deep learning technologies, it delivers production-ready 3D assets in seconds.

🎉 NEW: Standalone Image-to-3D System

Transform any image into a 3D model locally - no compilation required!

We've integrated TripoSR directly into the project with a custom implementation that works without pytorch3d. Simply drag and drop an image onto the launcher!

# Convert any image to 3D in seconds:
AIEXX_IMAGE_TO_3D.bat your_photo.png
# Output formats: OBJ, GLB, STL, PLY
# Processing time: 30-70 seconds
# Works 100% offline after first download

✅ Features:

• —🚀 No compilation needed (pure Python)
• —🗼️ Drag-and-drop interface
• —💻 Full GPU acceleration (RTX 5060)
• —🔐 100% local processing (privacy)
• —⚡ Professional quality output

📖 See [COMO_USAR_IMAGE_TO_3D.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/COMO_USAR_IMAGE_TO_3D.md) for complete guide

✨ Key Features

🎯 TEXT-TO-3D GENERATION
   ├─ Natural language prompts to 3D models
   ├─ Stable Diffusion 1.5 integration
   ├─ Advanced negative prompting
   └─ 20-60 seconds per model

🗼️ IMAGE-TO-3D CONVERSION
   ├─ Single image to full 3D mesh
   ├─ Multi-view reconstruction support
   ├─ Automated texture generation
   └─ 15-30 seconds processing time

⚡ GPU ACCELERATION
   ├─ NVIDIA RTX 5060 optimized
   ├─ CUDA 12.8 + cuDNN integration
   ├─ BF16 mixed precision training
   ├─ Flash Attention v2 support
   └─ PyTorch 2.7.0 performance mode

🎎 PROFESSIONAL OUTPUT
   ├─ GLB/GLTF format export
   ├─ PBR material support
   ├─ Configurable mesh resolution
   └─ Blender/Unity/Unreal ready

🚀 Quick Start

Prerequisites

Installation

Option 1: One-Click Automated Installation (⭐ EASIEST - Recommended)

# 1. Clone the repository
git clone https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D.git
cd AIEXX_GENAI_IMAGE_TO_3D

# 2. Run the automated installer
0-INSTALL_ALL_AUTOMATED.bat

# That's it! The installer will:
# ✅ Check system requirements
# ✅ Install all dependencies automatically
# ✅ Handle restart (run again after restart)
# ✅ Download all models
# ✅ Launch the system when done

Features:

• —✨ Single command installation
• —🔄 Auto-resume after restart
• —🛡️ Error handling and recovery
• —📊 Progress tracking with checkpoints
• —💡 Clear instructions at each step

See INSTALACAO_AUTOMATIZADA.md for complete documentation.

Option 2: Step-by-Step Installation (Advanced Users)

# 1. Clone the repository
git clone https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D.git
cd AIEXX_GENAI_IMAGE_TO_3D

# 2. Install Visual Studio Build Tools (⚠️ RESTART after this!)
1-INSTALL_VS_BUILDTOOLS_WINGET.bat

# 3. Setup Python environment and dependencies
2-FIX_VENV_AND_INSTALL_TORCH_SCATTER.bat

# 4. Install ComfyUI 3D Pack
3-RUN_INSTALL_3DPACK.bat

# 5. Download AI models
4-DOWNLOAD_3D_MODELS.bat

# 6. (Optional) Download Stable Diffusion models
5-SETUP_SD_MODELS.bat

# 7. Launch the system
6-START_AIEXX.bat

Option 3: Manual Setup

See INSTALLATION.md for detailed manual installation instructions.

First Run

1. 1.Start the System

   6-START_AIEXX.bat

1. 1.Access Web Interface
2. 2.Open browser: http://localhost:8188

1. 1.Load a Workflow
2. 2.Click "Load" → Select from workflows/3d/
3. 3.Recommended first workflow: 03_triposr_single_image_to_mesh.json

1. 1.Generate Your First 3D Model
2. 2.Upload an image or enter a text prompt
3. 3.Click "Queue Prompt"
4. 4.Wait ~20-60 seconds
5. 5.Download your .glb file from ComfyUI/output/

📋 Note: See ORDEM_DE_INSTALACAO.md for complete installation order and troubleshooting.

📖 Documentation

🎨 Workflows

Available Workflows

<table> <tr> <td width="33%">

🟢 Basic - TripoSR

`03_triposr_single_image_to_mesh.json`

Pipeline:

Image > TripoSR > GLB

Specs:

• —Time: ~15-30s
• —VRAM: 3-4GB
• —Best for: Quick prototypes

</td> <td width="33%">

🔵 Intermediate - Prompt to 3D

`basic/AIEXX_prompt_to_3d_triposr.json`

Pipeline:

Prompt > SD 1.5 > TripoSR > GLB

Specs:

• —Time: ~25-40s
• —VRAM: 4-5GB
• —Best for: Text-based creation

</td> <td width="33%">

🛳 Advanced - InstantMesh

`advanced/AIEXX_prompt_to_3d_instantmesh.json`

Pipeline:

Prompt > SD > Zero123++ > InstantMesh > GLB

Specs:

• —Time: ~45-90s
• —VRAM: 5-6GB
• —Best for: High-quality output

</td> </tr> </table>

⚙️ Technology Stack

Core AI/ML Technologies

📊 Performance Benchmarks

Processing Times (RTX 5060 8GB)

💫 Acknowledgments

This project builds upon these amazing open-source projects:

• —[ComfyUI](https://github.com/comfyanonymous/ComfyUI) - Node-based Stable Diffusion GUI
• —[Stable Diffusion](https://github.com/Stability-AI/stablediffusion) - Text-to-image foundation
• —[TripoSR](https://github.com/VAST-AI-Research/TripoSR) - Fast 3D reconstruction from single images
• —[PyTorch](https://pytorch.org/) - Deep learning framework
• —[PyTorch3D](https://pytorch3d.org/) - 3D deep learning library

Special thanks to:

• —Stability AI for Stable Diffusion
• —NVIDIA for CUDA toolkit and GPU support
• —Hugging Face for model hosting
• —The entire open-source AI community

🔧 Support & Community

• —Issues: GitHub Issues
• —Docs: GitHub Wiki
• —Email: aiexxplorer@artificialuniverse.tech

💫 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

<div align="center">

🚀 Ready to Transform Ideas into 3D Reality?

6-START_AIEXX.bat

[⬆ Back to Top](#aiexx-genai-image-to-3d)

Built with ❤️ by [AIEXX](https://github.com/AIExxplorer)

Optimized for NVIDIA RTX 5060 | Powered by AI

</div>