Hugging Face's logo

GemosDodo
/
MLSharp-TD-Bridge

Model card Files
xet
Community
MLSharp-TD-Bridge / README.md
GemosDodo's picture
GemosDodo
Update README.md
6130932 verified
preview code
|
raw
history blame contribute delete
3.79 kB

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) | English Version

image

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

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!