Qué es
Articraft usa un agente para generar objetos 3D articulados a partir de una descripción o una imagen. El modelo escribe código Python con el SDK del proyecto; el sistema lo compila, comprueba el resultado y exporta un archivo USDZ que puedes inspeccionar en su visor.
La página de la investigación y el repositorio original remiten a articraftresearch/Articraft como sucesor mantenido. Esta guía sigue ese código actual, cuya instalación difiere de la del prototipo de investigación.
Para qué te sirve
- Cuando necesitas explorar la forma y el movimiento de una lámpara o una silla plegable, puedes describir el objeto y revisar sus articulaciones en el visor.
- Cuando tienes una imagen de referencia, puedes usarla para orientar la reconstrucción en lugar de empezar únicamente con texto.
- Cuando investigas generación de activos para simulación, puedes conservar el código, las versiones y los registros de una ejecución para revisar cómo llegó al resultado.
Cómo funciona
Cada ejecución crea un espacio de trabajo con Python. El modelo lee las instrucciones del SDK, modifica los archivos y solicita una compilación. Las herramientas devuelven información para que pueda corregir su propuesta dentro de un límite de turnos.
El compilador carga el código en otro proceso, ejecuta las comprobaciones y exporta el USDZ. El registro conserva la conversación, los intentos y la ruta del resultado. El visor abre una ejecución terminada para comparar versiones y mover las articulaciones. La simulación es una capacidad opcional, con su propio grupo de dependencias.
Antes de empezar
El inicio rápido requiere Python 3.11 o posterior, uv y una clave de API de OpenAI. El archivo de proyecto exige uv 0.9.0 o posterior. También hay adaptadores para Anthropic, Gemini y OpenRouter, documentados por separado. OpenRouter solo admite texto en esta integración.
El código tiene licencia Apache-2.0; las llamadas al proveedor de modelos se facturan según tu cuenta. No hay un coste fijo confirmado por objeto. GitHub registra el último commit consultado el 30 de septiembre de 2026 y el repositorio no está archivado.
Límites y alternativas
El proyecto está en desarrollo anterior a la versión 1.0. Un resultado que compila sigue necesitando inspección: no presupongas precisión de ingeniería ni validez para tu simulador. El README documenta USDZ como salida; comprueba los requisitos de importación de tu herramienta de destino.
El agente ejecuta Python generado y dispone de herramientas de terminal. Un proceso separado de compilación no equivale a una barrera de seguridad para ejecutar código desconocido: usa un entorno de prueba sin datos sensibles. Los prompts y las imágenes se envían al proveedor elegido. Si necesitas controlar dimensiones y geometría de forma exacta, considera modelar directamente en una herramienta CAD y validar allí el resultado.
Recursos
- Repositorio mantenido - 140 estrellas, licencia Apache-2.0 en la consulta del 26 de octubre de 2026.
- Inicio rápido - generación, visor e imágenes de referencia.
- Diseño del agente - bucle, herramientas y archivos de ejecución.
- Proveedores - claves y límites de cada adaptador.
- Simulación - pruebas opcionales del resultado.
- Licencia - condiciones del código.