ES
Consigue Facetion

Documentación

Inicio rápido

Facetion se ejecuta en tu propio equipo desde la carpeta de la aplicación. Esta guía te lleva desde la instalación hasta tu primera ronda en la arena.

Los comandos y las variables de entorno siguen usando el nombre interno facet / FACET_.

01Requisitos

  • Bun 1.4
  • Blender 5.2 (las pruebas de campo usaron 5.2.2 LTS)
  • URL y clave de API de un proveedor de IA compatible con OpenAI
  • Opcional: ima2-gen para imágenes de IA, el puente TDMCP para TouchDesigner, Unreal Engine 5.8 con Unreal MCP

02Instala y ejecuta

Desde la carpeta de la aplicación de tu copia del código fuente, instala las dependencias e inicia el servidor; después abre la interfaz en el navegador.

cd <checkout>/app
bun install --frozen-lockfile
bun run start
# open http://127.0.0.1:5178

03Conecta tu proveedor y Blender

Abre Settings e introduce la dirección y la clave de API de tu proveedor compatible con OpenAI. La dirección predeterminada es http://127.0.0.1:8318/v1. La clave se almacena en el servidor y las respuestas de la API solo muestran un valor enmascarado. Define la ruta de Blender en Settings o con FACET_BLENDER.

04Ejecuta tu primera ronda

Crea una sesión, elige Blender, escribe una frase con el objetivo y, si quieres, añade una imagen de referencia. Ejecuta la ronda para obtener renders reales de Blender de varios modelos, en paralelo.

05Elige, continúa, crea ramas

Elige el resultado que te guste. La elección actualiza la guía del programa y el Elo de modelos y estrategias. Continúa desde ese resultado o haz clic en uno anterior del historial de generaciones para crear una rama desde allí.

06Imágenes de IA con ima2

El panel AI Image utiliza un servidor ima2-gen que se ejecuta en el mismo equipo. Facetion no lo inicia por ti, así que ejecuta primero ima2 start. La dirección predeterminada es http://127.0.0.1:3333; cámbiala con FACET_IMA2_URL o en el panel. Solo se aceptan 127.0.0.1 y localhost.

07Otros programas

TouchDesigner necesita el puente TDMCP y su archivo de configuración; sin conexión, se muestra el estado y las rondas quedan bloqueadas. Unreal, Cinema 4D, After Effects y ComfyUI necesitan que su programa, plugin o puente esté instalado y listo.

08Usa Facetion desde un agente de IA (MCP)

Inicia primero el servidor de Facetion y registra después este proceso en tu host MCP. Las herramientas incluyen facet_status, facet_create_session, facet_start_round, facet_wait_round, facet_pick y facet_get_render.

{
  "command": "bun",
  "args": [
    "<checkout>/app/src/mcp/stdio.ts"
  ],
  "env": {
    "FACET_URL": "http://127.0.0.1:5178"
  }
}

09Variables de entorno

  • FACET_PORT: puerto del servidor (por defecto, 5178)
  • FACET_DATA_DIR: directorio de datos (por defecto, .facet-data en la copia del código fuente)
  • FACET_BLENDER: ruta de Blender
  • FACET_IMA2_URL: dirección del servidor de ima2

10Conviene saber

  • El código generado para Blender se ejecuta en un proceso independiente con un tiempo límite y una comprobación estática del código. Esta comprobación no es un entorno aislado a nivel del sistema operativo.
  • La calidad de la salida de los modelos varía entre resultados. Consulta las puntuaciones visuales y examina los renders por tu cuenta.
  • La interfaz y los programas se ejecutan en tu equipo, pero las llamadas de IA se envían al proveedor que configures.
  • Los errores de los modelos quedan registrados en el registro de actividad y en las tarjetas de resultados.