Como Construir um Pipeline de Geração de Modelos 3D em Uma Única Janela com 3DGenStudio

Criar assets 3D com IA ainda parece montar um kit de construção com peças de diferentes conjuntos. Primeiro você gera uma imagem no ComfyUI, depois arrasta para um serviço de terceiros como o Tripo para obter uma malha tridimensional. Em seguida abre o Blender para corrigir a geometria ou fazer o UV unwrap, e então volta para redes neurais para texturas. Importar e exportar constantemente entre cinco janelas cansa rápido.

Um desenvolvedor com o nome de usuário visualbruno decidiu combinar esses passos. Seu projeto 3DGenStudio conecta gerenciamento de pipeline visual, um editor de arquivos de malha integrado e integração direta com ComfyUI em um único espaço de trabalho.

Por Que um Interface de Estúdio Separado É Necessária

A ideia central por trás do 3DGenStudio é eliminar o caos de arquivos, variantes de render e configurações de workflow. Em vez de várias pastas com nomes como mesh_final_v2_fixed.glb, você obtém um ambiente de desenvolvimento visual onde pode ver todo o caminho de um objeto desde o primeiro prompt de texto até um modelo finalizado com animação.

O projeto é local. Todos os arquivos de origem, texturas e versões de malha são salvos no seu disco. Não há dependência de nuvens de terceiros, e os dados são fáceis de enviar para o Git.

Dois Modos para Trabalhar com um Projeto

Dentro do app você pode alternar entre duas visualizações.

Quadro Kanban

Você avança o card de um objeto através de colunas padrão: geração de imagem, processamento de imagem, criação de malha 3D, refinamento de geometria, texturização. Em cada estágio, os scripts necessários do ComfyUI ou APIs externas podem ser iniciados diretamente do card.

Grafo de Nós

Se você preferir ver as conexões graficamente, o grafo mostra de qual imagem específica uma determinada malha foi gerada. Clicar em um nó abre os parâmetros de geração, onde você pode imediatamente alterar configurações e executar o processo novamente.

Editor 3D Integrado Diretamente no Navegador

A principal surpresa do projeto é um editor integrado baseado no Three.js. Não é destinado a substituir o Blender, mas para ajustar rapidamente os resultados de redes neurais.

O que o editor pode fazer:

• UV unwrap automático e retopologia. Malhas de redes neurais frequentemente produzem uma bagunça de polígonos. O script integrado pode limpar bordas desfeitas e reconstruir a malha em uma aparência mais organizada.
• Auto Rig. A função constrói um esqueleto e vincula pesos de skin com base na biblioteca SkinTokens.
• Projeção de textura e inpainting. Você pode girar o modelo para o ângulo desejado, pintar sobre um problema com uma máscara e enviar o frame para o ComfyUI. A rede neural preencherá o fragmento, e o editor projetará a peça finalizada de volta no objeto 3D.
• Escultura e pintura básica. Existem pincéis familiares para suavizar, construir forma e texturização localizada.

Integração Direta com ComfyUI

O 3DGenStudio pode se comunicar com o ComfyUI diretamente. Você não precisa transferir prompts manualmente ou recarregar máscaras. O app envia os parâmetros necessários para a API do ComfyUI, recupera o resultado gerado e o anexa como uma versão filha ao card atual.

Se você usa serviços de nuvem como Tripo AI ou Tencent Cloud, esses também podem ser conectados via endpoints de API externos.

Stack Tecnológico e Execução

O projeto consiste em três partes:

• Frontend: React, Vite, Three.js (@react-three/fiber).
• Backend: Node.js, Express, SQLite.
• Servidor Python: processa processamento pesado de 3D, retopologia e auto-rig.

Para executar, você precisará do Node.js instalado, um ComfyUI em execução e um ambiente Python.

# Клонируем репозиторий
git clone https://github.com/visualbruno/3DGenStudio.git
cd 3DGenStudio

# Устанавливаем и запускаем клиент
npm install
npm run dev

# В соседнем терминале поднимаем python-сервер
cd python-server
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python main.py

Depois disso, abra http://localhost:3001 e especifique seu endereço do ComfyUI nas configurações.

O Veredicto Final

No momento da escrita, o 3DGenStudio tem pouco mais de 400 estrelas no GitHub. No entanto, pelo CHANGELOG, o autor atualiza o projeto quase todos os dias, adicionando novas ferramentas como suporte ao modelo Flux, integração com Sam3.1 e otimizadores de malha.

Prós:

• Conecta ferramentas dispersas de geração 3D em um workflow claro.
• Automatiza a rotina de UV unwrap, retopologia e rigging.
• Todos os arquivos são armazenados localmente.

Contras:

• Requer deploy e manutenção de múltiplos serviços simultaneamente (Node.js, Python, ComfyUI).
• O editor baseado em navegador ainda não substitui um pacote 3D completo para modelagem complexa.

Se você está montando assets para jogos ou projetos indie usando redes neurais, experimentar o 3DGenStudio claramente vale a pena. O projeto economiza muito tempo em operações rotineiras entre a geração e exportação para um motor.