Biblioteca · Repositório

img2threejs/img2threejs

Imagem, vídeo e avatares · Python · Apache-2.0

Uma skill de agente de código que olha para a foto de um objeto e o reconstrói como código Three.js procedural, 3D editável e animável, sem arquivo de malha. Viralizou em semanas (quase 9 mil estrelas desde 15 de julho) porque demos de nomes como Gary Simon e Nicolas Zullo mostraram fotos virando cenas 3D funcionais dentro de jogos, quase sem intervenção humana.

O que é, em uma frase honesta

É uma skill que você instala no seu agente de código (Claude Code, Codex ou OpenCode) para transformar a imagem de um objeto em código Three.js que reconstrói aquele objeto em 3D no navegador. A diferença para as ferramentas de imagem-para-3D tradicionais: não sai um arquivo de malha pesado e opaco, sai código, uma 'fábrica' em TypeScript que monta o objeto a partir de formas primitivas, shaders procedurais e geometria gerada, com hierarquia pronta para animar (pivôs, encaixes, colisores). O processo é um pipeline em estágios (blocagem, estrutura, forma, material, superfície, luz, interação, otimização) em que o próprio agente olha o resultado de cada etapa e corrige até passar num portão de qualidade.

Traduzindo: é um escultor digital que trabalha por aproximações sucessivas, com um inspetor cobrando cada detalhe da foto original.

Para que serve na prática

Serve para criar ativos 3D leves e editáveis a partir de uma simples foto ou imagem gerada por IA. A galeria oficial mostra o alcance: skins de armas do Counter-Strike 2, uma bicicleta BMX, fones Sony, até um diorama da casa do Doraemon, tudo rodando como código no navegador, sem download de modelo. Casos concretos: uma página de produto com o item em 3D interativo (gire, aproxime, anime no scroll), protótipos de jogos em que a imagem conceitual vira o objeto jogável, experiências de marca com efeitos 3D sob medida.

O demo do Nicolas Zullo emendou as três pontas: gerar a imagem por IA, converter em 3D com a skill e integrar automaticamente no próprio jogo. Como é código, o resultado pesa pouco e pode ser ajustado depois, cor, material, animação, sem refazer nada do zero.

Quando faz sentido pra você que lidera

Faz sentido se o seu produto ou marketing se beneficiaria de 3D interativo, e-commerce, configuradores de produto, landing pages de impacto, jogos e experiências, e hoje isso esbarra no custo de um estúdio 3D ou em modelos gerados por IA que chegam pesados e impossíveis de editar. Aqui o ativo nasce como código: seu time de front-end consegue mexer, versionar e auditar. Os limites: exige que sua equipe já use um agente de código (é uma skill, não um aplicativo de prateleira), o resultado é estilizado e procedural (ótimo para objetos de superfície dura, não substitui fotogrametria de precisão), e o projeto tem semanas de vida, roadmap ambicioso, mas ainda cedo para apostar processo crítico nele.

Licença Apache-2.0, sem trava comercial. Custo real: os tokens do agente durante a escultura.

Por que está no mapa

Crescimento raro de se ver: o repositório nasceu em 15 de julho de 2026 e chegou perto de 9.000 estrelas em pouco mais de duas semanas, com 686 forks e commits diários. O combustível foram demos virais: Gary Simon (DesignCourse) testando a biblioteca em cenas Three.js performáticas, Nicolas Zullo integrando imagem gerada por IA direto num jogo, e Meng To (Design+Code) destacando o pulo do gato, IA gera imagem bem, mas apanha em 3D editável, e esta skill fecha essa lacuna. É também vitrine de um padrão emergente: skills que dão superpoderes visuais a agentes de código.

Ver no GitHub →
O que você achou desta página?
Recomendaria esta página para alguém do seu time?