| # MLSharp-TD-Bridge (2D to 3D Gaussian Splatting) | |
| > **One-click 2D to 3D Gaussian Splatting Tool for TouchDesigner | Portable AI Bridge** | |
| > **Author:** GemosDodo | |
| [中文版 (Chinese Version)](./README_zh-CN.md) | [English Version](./README.md) | |
| <img width="1780" height="842" alt="image" src="https://github.com/user-attachments/assets/94273fd8-546f-41e1-b8c9-089944bb0463" /> | |
| ## Introduction | |
| **MLSharp-TD-Bridge** is a portable AI bridge tool built specifically for TouchDesigner. Based on Apple's **Sharp** model architecture, it achieves **one-click conversion of 2D images into high-quality 3D Gaussian Splatting models directly within TouchDesigner**. | |
| Traditional AI generation often involves tedious Python environment configuration, complex dependency installations (CUDA, PyTorch, etc.), and command-line operations. The goal of this project is to completely "automate" and "black-box" this process. | |
| **Designers do not need to write a single line of code. Simply drag in an image, and obtain 3D assets within seconds.** | |
| ## 💾 Download | |
| Due to GitHub file size limits (this project includes a fully portable Python environment), please download the complete project files via **Hugging Face**. | |
| > **Hugging Face (High Speed / Global):** [Click here to visit Repository](https://huggingface.co/GemosDodo/MLSharp-TD-Bridge) | |
| > | |
| > *Please go to the "Files and versions" tab and download the `.zip` file.* | |
| --- | |
| ## Features | |
| * **Zero-Config & Plug-and-Play** | |
| Includes a complete portable Python environment (containing PyTorch, CUDA, gsplat, sharp, etc.). After downloading and unzipping, there is **no need to install Anaconda**. Just run the `.toe` file directly. | |
| * **Fully Automated Workflow** | |
| With a single button click, the script automatically handles: `Save Image` -> `Clean Old Files` -> `AI Inference` -> `Rename Files` -> `Refresh 3D View`. | |
| * **Native TouchDesigner Integration** | |
| * **Input**: Supports any TOP image source (Movie File In, Noise, etc.). | |
| * **Output**: Generated results are automatically loaded back into a Point File In for immediate preview in the TD viewport. | |
| * 🛠 **Offline Privacy** | |
| All calculations are performed locally on your GPU. No internet connection is required, ensuring data privacy. | |
| ## Requirements | |
| * **OS**: Windows 10 / 11 (64-bit) | |
| * **GPU**: NVIDIA GPU (Recommended: 6GB+ VRAM, CUDA support required) | |
| * **Software**: TouchDesigner 2022.x or 2023.x and above | |
| ## Getting Started | |
| 1. **Download the Project** | |
| Download the project zip file from the **Hugging Face** link above and unzip the entire folder. | |
| > **⚠️ Note**: Please ensure the unzipped file path **does not contain non-English characters** (e.g., `D:\MLSharp_Bridge`) to avoid Python path errors. | |
| 2. **Launch the Project** | |
| Double-click to run `MLSharp-TD-Bridge-by-GemosDodo.toe`. | |
| 3. **One-Click Generation** | |
| Select the `Sharp_3D_Bridge` component. In the custom parameters panel, click the **`Generate`** button. | |
| 4. **View Results** | |
| Wait for approximately 30-60 seconds (depending on GPU performance). The generated 3D model will automatically load into the preview window on the right. | |
| ## Acknowledgements | |
| This project utilizes the **TouchDesigner 3D Gaussian Splatting Toolkits** open-sourced by **Yea Chen** to visualize the generated Gaussian Splatting 3D models. | |
| This is my first open-source project, standing on the shoulders of giants. This project is non-profit and free for everyone. I hope you enjoy using it in your TouchDesigner learning or creative process! | |
| * **ML_Sharp GitHub**: [https://github.com/apple/ml-sharp](https://github.com/apple/ml-sharp) | |
| * **TouchDesigner 3D Gaussian Splatting Toolkits**: [https://github.com/yeataro/TD-Gaussian-Splatting](https://github.com/yeataro/TD-Gaussian-Splatting) |