--- license: apache-2.0 language: - pt - en base_model: - stabilityai/stable-diffusion-1-5 pipeline_tag: image-to-3d tags: - text-to-3d - image-to-3d - 3d-generation - 3d-reconstruction - stable-diffusion - triposr - comfyui - mesh-generation - gpu-optimized - nvidia - pytorch library_name: pytorch metrics: - inference_time - vram_usage ---
``` █████╗ ██╗███████╗██╗ ██╗██╗ ██╗ ██╔══██╗██║██╔════╝╚██╗██╔╝╚██╗██╔╝ ███████║██║█████╗ ╚███╔╝ ╚███╔╝ ██╔══██║██║██╔══╝ ██╔██╗ ██╔██╗ ██║ ██║██║███████╗██╔╝ ██╗██╔╝ ██╗ ╚═╝ ╚═╝╚═╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ```
# **AIEXX GenAI Image to 3D** ### 🚀 Enterprise-Grade AI-Powered 3D Model Generation System **Transform Text & Images into Production-Ready 3D Assets in Seconds** --- [![Version](https://img.shields.io/badge/version-1.0.0-blue.svg?style=for-the-badge&logo=semantic-release)](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/releases) [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-green.svg?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0) [![Python](https://img.shields.io/badge/Python-3.11.9-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/) [![PyTorch](https://img.shields.io/badge/PyTorch-2.7.0-EE4C2C?style=for-the-badge&logo=pytorch&logoColor=white)](https://pytorch.org/) [![CUDA](https://img.shields.io/badge/CUDA-12.8-76B900?style=for-the-badge&logo=nvidia&logoColor=white)](https://developer.nvidia.com/cuda-toolkit) [![GPU Optimized](https://img.shields.io/badge/GPU-RTX%205060%20Optimized-76B900.svg?style=for-the-badge&logo=nvidia)](https://www.nvidia.com/) [![ComfyUI](https://img.shields.io/badge/ComfyUI-Latest-orange.svg?style=for-the-badge)](https://github.com/comfyanonymous/ComfyUI) [![Stable Diffusion](https://img.shields.io/badge/Stable%20Diffusion-1.5-blueviolet?style=for-the-badge)](https://huggingface.co/) [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg?style=for-the-badge)](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D) [![Stars](https://img.shields.io/github/stars/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D?style=social)](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/stargazers) [![Forks](https://img.shields.io/github/forks/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D?style=social)](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/network/members) [![Issues](https://img.shields.io/github/issues/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D?style=social&logo=github)](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/issues) --- **[🚀 Quick Start](#-quick-start)** • **[📖 Documentation](#-documentation)** • **[🎨 Workflows](#-workflows)** • **[⚙️ Tech Stack](#%EF%B8%8F-technology-stack)** • **[📊 Performance](#-performance-benchmarks)** • **[🤝 Contributing](#-contributing)**
--- ## 🌟 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! ```batch # 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 | Component | Requirement | Status | |-----------|------------|--------| | **OS** | Windows 10/11 (64-bit) | ✅ | | **GPU** | NVIDIA RTX 5060 (8GB VRAM) | ✅ | | **RAM** | 16GB minimum, 32GB recommended | ✅ | | **Storage** | ~55GB free space | ✅ | | **Python** | 3.11.9 | ✅ | ### Installation #### Option 1: **One-Click Automated Installation** (⭐ EASIEST - Recommended) ```batch # 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](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/INSTALACAO_AUTOMATIZADA.md) for complete documentation. #### Option 2: Step-by-Step Installation (Advanced Users) ```batch # 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](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/INSTALLATION.md) for detailed manual installation instructions. ### First Run 1. **Start the System** ```batch 6-START_AIEXX.bat ``` 2. **Access Web Interface** - Open browser: **http://localhost:8188** 3. **Load a Workflow** - Click **"Load"** → Select from `workflows/3d/` - Recommended first workflow: `03_triposr_single_image_to_mesh.json` 4. **Generate Your First 3D Model** - Upload an image or enter a text prompt - Click **"Queue Prompt"** - Wait ~20-60 seconds - Download your `.glb` file from `ComfyUI/output/` > 📋 **Note:** See [ORDEM_DE_INSTALACAO.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/ORDEM_DE_INSTALACAO.md) for complete installation order and troubleshooting. --- ## 📖 Documentation | Document | Description | |----------|-------------| | [📋 ORDEM_DE_INSTALACAO.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/ORDEM_DE_INSTALACAO.md) | **Installation order and numbered scripts** | | [📘 COMO_USAR.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/COMO_USAR.md) | Complete usage guide (Portuguese) | | [🚀 QUICK_START_GUIDE.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/QUICK_START_GUIDE.md) | Quick start guide | | [🔧 INSTALLATION.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/INSTALLATION.md) | Detailed installation guide | | [📋 README_NEXT_STEPS.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/README_NEXT_STEPS.md) | Next steps after installation | | [⚙️ SETUP_COMPLETE_3D_SYSTEM.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/SETUP_COMPLETE_3D_SYSTEM.md) | Complete system setup | | [🚀 RELEASE_GUIDE.md](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/blob/main/RELEASE_GUIDE.md) | Release and versioning guide | --- ## 🎨 Workflows ### Available Workflows
#### 🟢 Basic - TripoSR **`03_triposr_single_image_to_mesh.json`** **Pipeline:** ``` Image > TripoSR > GLB ``` **Specs:** - Time: ~15-30s - VRAM: 3-4GB - Best for: Quick prototypes #### 🔵 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 #### 🛳 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
--- ## ⚙️ Technology Stack ### Core AI/ML Technologies | Technology | Version | Purpose | |------------|---------|----------| | Python | 3.11.9 | Core Language | | PyTorch | 2.7.0+cu128 | Deep Learning Framework | | CUDA Toolkit | 12.8 | GPU Acceleration | | Stable Diffusion | 1.5 | Image Generation | | TripoSR | Latest | 3D Reconstruction | | torch_scatter | 2.1.2 | Sparse Operations | | ComfyUI | Latest | UI Framework | | ComfyUI-3D-Pack | Latest | 3D Nodes & Tools | --- ## 📊 Performance Benchmarks ### Processing Times (RTX 5060 8GB) | Workflow | Input Type | Speed | VRAM Usage | |----------|-----------|-------|------------| | TripoSR (Image>3D) | Single Image | 15-30s | 3-4GB | | TripoSR (Prompt>3D) | Text Prompt | 25-40s | 4-5GB | | InstantMesh | Text Prompt | 45-90s | 5-6GB | | Zero123 Multi-View | Single Image | 30-60s | 4-5GB | --- ## 💫 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](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/issues) - **Docs:** [GitHub Wiki](https://github.com/AIExxplorer/AIEXX_GENAI_IMAGE_TO_3D/wiki) - **Email:** [aiexxplorer@artificialuniverse.tech](mailto:aiexxplorer@artificialuniverse.tech) --- ## 💫 License This project is licensed under the **Apache 2.0 License** - see the [LICENSE](LICENSE) file for details. ---
### 🚀 Ready to Transform Ideas into 3D Reality? ```batch 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** ![Footer](https://img.shields.io/badge/Made%20with-Python%20%7C%20PyTorch%20%7C%20CUDA-blue?style=for-the-badge)