Nova3D

O que é Nova3D?

Nova3D é um cliente open-source para nova3d.xyz que gera ativos 3D como procedimentos de construção executáveis, em vez de uma única malha mesclada. Ele produz scripts Python nativos do Blender e retorna um GLB estruturado onde as partes são nomeadas e endereçáveis separadamente.

O propósito principal deste cliente é conectar-se à pipeline Nova3D hospedada (por padrão), para que você possa gerar saídas 3D editáveis e com partes a partir de prompts de texto ou imagens de referência.

Principais Recursos

• Saídas 3D editáveis e com partes: A pipeline gera um GLB estruturado com partes nomeadas e endereçáveis separadamente, projetado para edições direcionadas (ex.: alterar uma parte sem regenerar tudo).
• Geração script-native (prompt-to-code / image-to-code): Em vez de “image-to-3D” estilo difusão que resulta em uma malha mesclada única, Nova3D gera scripts Python do Blender que representam o procedimento de construção.
• Usa o grafo de cena do Blender como representação nativa: O cliente alinha seu modelo de saída com o grafo de cena do Blender, que suporta hierarquia lógica e fluxos de edição em nível de cena.
• Fluxo de cliente agnóstico a modelo/LLM: O harness de geração pode alternar entre backends LLM via configurações (ex.: Claude 3.5, GPT-4o ou Gemini 1.5 Pro), com validação/execução gerenciada pela pipeline.
• Editor de viewport web integrado: Inclui um editor Three.js embutido com ferramentas de transformação, snapping e edição de materiais.
• Orientação por imagem de referência: Permite anexar uma foto para guiar a lógica espacial do script gerado.
• Cache local no navegador: Modelos são armazenados em cache no navegador para que você possa ver seu histórico mesmo após URLs remotas expirarem.

Como Usar Nova3D

1. Execute o cliente localmente: Clone o repositório, instale dependências (flutter pub get) e inicie a UI web local.
   • O quick start observa que a porta 5555 é necessária para autorização de redirecionamento OAuth.
2. Faça login: Abra a URL local e faça login usando Google ou Email.
3. Adicione uma chave de API nas configurações: O cliente suporta adicionar chaves de API para OpenAI, Anthropic ou Gemini.
4. Forneça entrada e gere: Insira um prompt (e opcionalmente anexe uma imagem de referência) e execute o fluxo de geração.
5. Edite e revise resultados: Use o editor de viewport integrado para transformações/snapping/edição de materiais, e conte com cache local para revisitar gerações anteriores.

Para implantar uma build de produção para hospedagem estática, o repositório inclui um comando para compilar o app web Flutter (flutter build web --release).

Casos de Uso

• Geração de ativos editáveis para fluxos que exigem hierarquia: Gere modelos 3D onde partes são nomeadas e parentadas para que você possa ajustar componentes individuais sem regenerar o resultado completo.
• Ideação 3D por prompt ou guiada por foto: Use prompts de texto ou anexe imagens de referência para influenciar a lógica espacial dos scripts de construção gerados.
• Iteração de materiais com fluxo de mapeamento PBR: Trabalhe com saídas projetadas para suportar mapeamento de materiais em vez de depender de cores de vértice assadas.
• Revisão e ajuste rápidos no navegador: Use o editor de viewport Three.js integrado (ferramentas de transformação, snapping e edição de materiais) sem sair do cliente.
• Navegação local de gerações anteriores: Aproveite o cache no navegador para manter o histórico de visualização mesmo quando URLs remotas expiram.

FAQ

• Nova3D gera uma malha mesclada única? Não. A pipeline é descrita como produzindo um GLB estruturado com partes endereçáveis separadamente, gerado a partir de scripts Python nativos do Blender.

• Posso usar diferentes provedores LLM? Sim. O cliente é descrito como agnóstico a modelos, com configurações permitindo alternar entre backends como Claude 3.5, GPT-4o ou Gemini 1.5 Pro.

• Que configuração local é necessária para login? O quick start observa que a porta 5555 é necessária para autorização de redirecionamento OAuth, e alerta especificamente que usar localhost:5555 pode falhar no Google Sign-In devido a políticas de origem OAuth.

• Para onde o cliente envia requisições de geração por padrão? Por padrão, ele se comunica com a API hospedada em nova3d.xyz. Um backend personalizado pode ser direcionado definindo API_BASE_URL via --dart-define.

• Há como influenciar a geração com uma imagem? Sim. O cliente suporta imagens de referência para que você possa anexar uma foto e guiar a lógica espacial do script gerado.

Alternativas

• Ferramentas de difusão imagem-para-3D que geram uma única malha mesclada: Essas tendem a focar na produção de um resultado geométrico consolidado único, o que difere das saídas editáveis e com partes da Nova3D.
• Sistemas no estilo OpenSCAD/CSG focados em modelagem sólida: Abordagens dessa categoria podem priorizar sólidos manifold, mas podem sacrificar a flexibilidade de formas orgânicas e a editabilidade detalhada de hierarquia/materiais.
• Ferramentas prompt-para-CAD ou CAD procedural: Se o seu objetivo principal é construção procedural editável, procure ferramentas que suportem fluxos de trabalho semelhantes a scripts ou paramétricos, em vez de saídas de malhas puramente generativas.
• Ferramentas autônomas de modelagem/edição 3D combinadas com resultados procedurais importáveis: Para fluxos de trabalho onde você já usa Blender ou outras ferramentas DCC, pode tratar a Nova3D como a etapa de geração e refinar as saídas em um ambiente de modelagem — embora a diferença chave seja a geração de scripts nativos do Blender e estrutura GLB com partes pela Nova3D.