# Instrucciones para el agente: Articraft: genera objetos 3D articulados mediante un agente 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: avanzado - Proyecto: https://github.com/articraftresearch/Articraft (licencia Apache-2.0) - Guía completa: https://lab.wisd.ai/hub/articraft --- ## 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 ### Paso 1: prepara el repositorio mantenido Abre [articraftresearch/Articraft](https://github.com/articraftresearch/Articraft), descarga su código con la opción Code de GitHub y abre la carpeta raíz. Evita aplicar las instrucciones antiguas de `mattzh72/articraft`: ese repositorio remite al sucesor. Necesitas Python 3.11 o posterior y uv 0.9.0 o posterior. Trabaja en un entorno de prueba, ya que el proyecto ejecuta código Python generado por el modelo. ### Paso 2: instala las dependencias Desde la raíz del código descargado, ejecuta el comando del README: ```bash uv sync --group dev ``` ### Paso 3: configura el proveedor El caso predeterminado usa OpenAI. En tu entorno de prueba, crea el archivo `.env` que indica el README y define `OPENAI_API_KEY` con tu propia clave. No la incluyas en el repositorio ni en capturas o registros compartidos. Para otros proveedores, sigue la [guía oficial](https://github.com/articraftresearch/Articraft/blob/HEAD/docs/providers.md). Confirma acceso y facturación antes de iniciar la generación. ### Paso 4: genera un objeto Ejecuta el ejemplo oficial: ```bash uv run articraft "un motor a reacción" ``` La ejecución queda en `runs/`. Conserva la ruta que genere; no inventes el identificador de la ejecución. ### Paso 5: inspecciona el resultado Sustituye `` por el identificador real de la ejecución completada: ```bash uv run articraft view runs/ ``` Revisa las versiones del objeto y mueve sus articulaciones en el visor. Si necesitas una imagen de referencia, el README documenta este ejemplo; requiere que exista `reference.png`: ```bash uv run articraft --image reference.png "reconstruye esta lámpara de escritorio" ``` ## Comprobación Confirma que la ejecución terminó correctamente y produjo un USDZ. Consulta `record.json` para ver el estado, los intentos de compilación y la ruta del resultado; revisa la geometría y el movimiento en el visor. Estas comprobaciones son distintas de validar el objeto en tu aplicación de destino. ## Si algo falla Si faltan dependencias, confirma las versiones requeridas y que ejecutas los comandos desde la raíz. Si el proveedor rechaza la solicitud, revisa la clave, el acceso al modelo y los límites de tu cuenta sin compartir sus valores. Si la ejecución acaba sin USDZ, consulta su `record.json` y `conversation.jsonl`: el agente tiene límites de turnos y puede terminar sin una compilación válida. Simplifica el objeto o revisa el código generado antes de repetir llamadas con coste. No uses imágenes con OpenRouter: la integración solo acepta texto.