# Img2threejs

> Use al convertir una imagen en modelo 3D Three.js.

- Skill: `ntizar/img2threejs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ntizar/img2threejs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ntizar/img2threejs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ntizar (https://skillmd.com/u/ntizar)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ntizar/img2threejs

---


# img2threejs — imagen → modelo Three.js procedural

Reconstruye el objeto de una imagen de referencia como modelo Three.js **solo con código** (paramétrico/procedural), listo para animar. Repo: https://github.com/img2threejs/img2threejs (14k+ ⭐, Apache-2.0, Python 3.10+ stdlib en `forge/`, TypeScript para el output).

## Cuándo usarlo
- Necesitas un 3D "bonito y liviano" de un objeto conocido (vehículo, edificio, mueble) sin descargar assets ni mallas.
- El output debe ser animable y editable por código (ideal para dashboards, demos, World3D).

## Flujo
1. Clonar el repo y ejecutar el forge CLI con la imagen de referencia: `python forge/` (ver README para flags exactos).
2. El forge genera un módulo TypeScript que construye la escena con primitivas/paramétricas (sin mallas descargadas).
3. Iterar contra los **quality gates** automáticos (silueta, proporciones, colores): el pipeline re-chequea el render contra la imagen y rechaza versiones fuera de tolerancia.
4. Integrar el módulo generado en tu escena Three.js; el modelo es code-only → diff-able y versionable en git.

## Patrones clave
- **Reconstrucción-por-código** vs fotogrametría: sin pesos, sin assets binarios, token-efficient para agentes.
- **Quality gates iterativos**: comparación render↔referencia como bucle de verificación (aplicable a cualquier pipeline generativo visual).
- **Output paramétrico**: árbol de primitivas con parámetros expuestos → animable por código.

## Pitfalls
- No sirve para objetos orgánicos complejos (caras, esculturas): mejor fotogrametría/modelos ML.
- El forge es Python stdlib: no necesita pip, pero requiere Python 3.10+.
- Los quality gates pueden iterar varias veces: presupuesta llamadas de render.

## Verificación
- Renderizar el módulo generado en una página Three.js mínima y comprobar silueta vs la imagen original.
- Confirmar que no hay assets binarios en el output (solo TS/JS).