# Instrucciones para el agente: 3DCellForge: genera y revisa modelos 3D desde imágenes

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/huangserva/3DCellForge (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/3dcellforge

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba Node.js ≥22.19.0 y npm antes de abrir la carpeta del proyecto. Aunque el README no fija mínimo, el [manifiesto](https://github.com/huangserva/3DCellForge/blob/main/package.json) instala Vite 8 (Node ^20.19.0 o ≥22.12.0) y undici 8 (Node ≥22.19.0); usa el requisito más exigente de la cadena.

### Paso 1: prepara el código

Descarga el repositorio desde https://github.com/huangserva/3DCellForge y abre su carpeta. Empieza por los GLB de demostración o un archivo local.

### Paso 2: inicia el frontend

Comandos del README:

```bash
npm install
npm run dev
```

Abre la URL de Vite que aparezca en la terminal.

### Paso 3: prueba la biblioteca

Selecciona un modelo o usa Local GLB para importar uno propio. Gira y amplía la vista, inspecciona el modelo y comprueba la exportación.

### Paso 4: activa generación solo si la necesitas

Lee Optional Image-to-3D Backend y configura únicamente el proveedor elegido en el archivo local que indica el proyecto. Después inicia el backend en otra terminal:

```bash
npm run dev:api
```

Mantén también el frontend activo. No pongas las claves en código del navegador.

## Comprobación

Comprueba que el modelo importado aparece en Library y persiste tras recargar. Verifica que puedes visualizarlo y exportarlo. Si pruebas generación, revisa la cola y el GLB final, no solo el estado de la petición.

## Si algo falla

Si la vista local funciona pero la generación falla, revisa el backend y el proveedor. Para Hunyuan3D consulta la forma esperada de sus endpoints en el README. Si falla una referencia remota, prueba un GLB local para distinguir problemas de carga y de red.