Repolode
Enviar
Supra-3D

Supra-3D/SUPRA-Tex

Genera recursos 3D con texturas que se pueden volver a iluminar (GLB con mapas de color base, metalicidad y rugosidad) a partir de una sola imagen, y también permite aplicar texturas a mallas existentes.

Ver en GitHubSitio web
Estrellas
683
Forks
35
Issues abiertos
4
Último commit
hace 9 días

¿Qué es?

SUPRA-Tex convierte una sola imagen en un recurso 3D con materiales de renderizado basado en la física (PBR). Predice los materiales en la vista de referencia, los codifica como observaciones 3D alineadas con la superficie y usa un Interleaved Flow Transformer para completar las regiones que la cámara no puede ver. El objetivo es conservar en la superficie visible los detalles finos de la imagen de entrada, como letras, patrones y límites entre materiales.

El resultado es un archivo GLB con texturas de color base, metalicidad y rugosidad, que se puede renderizar con una iluminación distinta. Además de convertir imágenes en modelos 3D, el mismo flujo de trabajo puede aplicar texturas a una malla existente si se proporcionan su cámara, una imagen del primer plano y mapas de materiales de la vista de referencia. El modo de doble vista añade una vista posterior generada para que el lado no visible también siga una imagen.

El proyecto requiere Linux, una GPU NVIDIA y CUDA 12.4. Incluye una aplicación web local de Gradio y scripts de línea de comandos. Para acceder a algunos modelos del flujo de trabajo, como DINOv3 y RMBG-2, se necesita una aprobación aparte en Hugging Face.

Funciones clave

  • 01Genera recursos GLB con texturas de color base, metalicidad y rugosidad.
  • 02Conserva en las superficies visibles las letras, los patrones y los límites entre materiales de la imagen de entrada.
  • 03Completa las texturas de las regiones no visibles con un Interleaved Flow Transformer.
  • 04Aplica texturas a mallas existentes si se proporcionan una cámara, una imagen del primer plano y mapas de materiales.
  • 05Incluye una aplicación web local de Gradio y scripts de línea de comandos.
  • 06Ofrece un refinamiento opcional de texturas y un prefiltrado de profundidad para los límites de oclusión.

Casos de uso

  • Crear objetos o recursos 3D con texturas a partir de una foto de producto o de referencia.
  • Aplicar texturas a una malla existente que ya tenga geometría y datos de cámara.
  • Generar recursos PBR que se deban volver a iluminar en un motor 3D o renderizador.
  • Probar la generación de modelos 3D a partir de imágenes con una sola GPU NVIDIA.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/Supra-3D/SUPRA-Tex.git
  2. 2

    Instala el runtime en el entorno Conda activado (se requieren Python 3.10, CUDA 12.4 y nvcc)

    python scripts/install_runtime.py --conda
  3. 3

    Inicia sesión en Hugging Face, solicita la aprobación para acceder a DINOv3 y descarga los modelos

    python scripts/prepare_models.py
  4. 4

    Ejecuta el ejemplo incluido para generar un GLB con texturas

    python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

Antes de usarlo

  • Se requiere Linux con una GPU NVIDIA y el toolkit CUDA 12.4.
  • El proceso de imagen a 3D depende de DINOv3, cuyo acceso restringido requiere aprobación en Hugging Face.
  • Las imágenes RGB sin canal alfa también requieren RMBG-2 o BiRefNet.

Temas

#3d-generation#pbr#texture-generation#mesh#image-to-3d#diffusion#cuda#3d#3dgeneration

Preguntas frecuentes

¿Qué es SUPRA-Tex?
Genera recursos 3D con texturas que se pueden volver a iluminar (GLB con mapas de color base, metalicidad y rugosidad) a partir de una sola imagen, y también permite aplicar texturas a mallas existentes. SUPRA-Tex convierte una sola imagen en un recurso 3D con materiales de renderizado basado en la física (PBR). Predice los materiales en la vista de referencia, los codifica como observaciones 3D alineadas con la superficie y usa un Interleaved Flow Transformer para completar las regiones que la cámara no puede ver. El objetivo es conservar en la superficie visible los detalles finos de la imagen de entrada, como letras, patrones y límites entre materiales.
¿SUPRA-Tex es gratuito? ¿Qué licencia tiene?
SUPRA-Tex es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿SUPRA-Tex sigue mantenido?
Mantenimiento activo. El último commit de SUPRA-Tex fue el 29 oct 2026.
¿Para qué puedo usar SUPRA-Tex?
Crear objetos o recursos 3D con texturas a partir de una foto de producto o de referencia. Aplicar texturas a una malla existente que ya tenga geometría y datos de cámara. Generar recursos PBR que se deban volver a iluminar en un motor 3D o renderizador. Probar la generación de modelos 3D a partir de imágenes con una sola GPU NVIDIA.
¿Cómo se instala SUPRA-Tex?
Clona el repositorio: git clone https://github.com/Supra-3D/SUPRA-Tex.git Instala el runtime en el entorno Conda activado (se requieren Python 3.10, CUDA 12.4 y nvcc): python scripts/install_runtime.py --conda Inicia sesión en Hugging Face, solicita la aprobación para acceder a DINOv3 y descarga los modelos: python scripts/prepare_models.py Ejecuta el ejemplo incluido para generar un GLB con texturas: python scripts/run_example.py --output outputs/spiny_whelk_shell.glb
¿Dónde consigo SUPRA-Tex?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Supra-3D/SUPRA-Tex

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados