Supra-3D/SUPRA-Tex

O que é?

Recursos principais

• 01Gera assets GLB com texturas de cor base, metallic e roughness.
• 02Preserva letras, padrões e limites entre materiais da imagem de entrada nas superfícies visíveis.
• 03Completa as texturas de regiões não visíveis com um Interleaved Flow Transformer.
• 04Texturiza meshes existentes quando fornecidos uma câmera, uma imagem do primeiro plano e mapas de materiais.
• 05Inclui um app web local em Gradio e scripts de linha de comando.
• 06Oferece refinamento opcional de textura e um pré-filtro de profundidade para limites de oclusão.

Casos de uso

• Criar props ou assets 3D texturizados a partir de uma foto de produto ou referência.
• Texturizar um mesh existente que já tenha geometria e dados da câmera.
• Produzir assets PBR que precisam receber nova iluminação em uma engine 3D ou renderer.
• Experimentar a geração de imagem para 3D em uma única GPU NVIDIA.

Início rápido

1. 1

   Clone o repositório

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

   Instale o runtime no ambiente Conda ativado (é necessário ter Python 3.10, CUDA 12.4 e nvcc)

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

   Faça login no Hugging Face, obtenha aprovação para acessar o DINOv3 e baixe os modelos

   python scripts/prepare_models.py
4. 4

   Execute o exemplo incluído para gerar um GLB com textura

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

Antes de usar

• !É necessário usar Linux com uma GPU NVIDIA e o toolkit CUDA 12.4.
• !O pipeline de imagem para 3D depende do DINOv3, que exige aprovação para acesso restrito no Hugging Face.
• !Entradas RGB sem canal alfa também precisam do RMBG-2 ou do BiRefNet.

Tópicos

Perguntas frequentes

O que é SUPRA-Tex?

Gera assets 3D texturizados e relightable (GLB com mapas de cor base, metallic e roughness) a partir de uma única imagem, e também pode texturizar meshes existentes. O SUPRA-Tex transforma uma única imagem em um asset 3D com materiais de renderização baseada em física (PBR). Ele prevê os materiais na vista de referência, codifica-os como observações 3D alinhadas à superfície e usa um Interleaved Flow Transformer para preencher as regiões que a câmera não consegue ver. O objetivo é preservar na superfície visível os detalhes finos da imagem de entrada, como letras, padrões e limites entre materiais.

SUPRA-Tex é gratuito? Qual é a licença?

SUPRA-Tex é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

SUPRA-Tex ainda é mantido?

Manutenção ativa. O último commit de SUPRA-Tex foi em 29 de out. de 2026.

Para que posso usar SUPRA-Tex?

Criar props ou assets 3D texturizados a partir de uma foto de produto ou referência. Texturizar um mesh existente que já tenha geometria e dados da câmera. Produzir assets PBR que precisam receber nova iluminação em uma engine 3D ou renderer. Experimentar a geração de imagem para 3D em uma única GPU NVIDIA.

Como instalar SUPRA-Tex?

Clone o repositório: git clone https://github.com/Supra-3D/SUPRA-Tex.git Instale o runtime no ambiente Conda ativado (é necessário ter Python 3.10, CUDA 12.4 e nvcc): python scripts/install_runtime.py --conda Faça login no Hugging Face, obtenha aprovação para acessar o DINOv3 e baixe os modelos: python scripts/prepare_models.py Execute o exemplo incluído para gerar um GLB com textura: python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

Onde consigo SUPRA-Tex?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Supra-3D/SUPRA-Tex