Documentation

Démarrage rapide

Facetion s’exécute en local sur votre propre ordinateur depuis le dossier de l’application. Ce guide vous mène de l’installation à votre première manche dans l’arène.

Les commandes et variables d’environnement utilisent toujours le nom interne facet / FACET_.

01Prérequis

Bun 1.4
Blender 5.2 (les tests de terrain ont utilisé 5.2.2 LTS)
L’URL et la clé API d’un fournisseur d’IA compatible OpenAI
Facultatif : ima2-gen pour les images IA, la passerelle TDMCP pour TouchDesigner, Unreal Engine 5.8 avec Unreal MCP

02Installer et lancer

Depuis le dossier de l’application dans votre copie du code source, installez les dépendances et démarrez le serveur, puis ouvrez l’interface dans votre navigateur.

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

03Connecter votre fournisseur et Blender

Ouvrez les paramètres et saisissez l’adresse de votre fournisseur compatible OpenAI ainsi que votre clé API. L’adresse par défaut est http://127.0.0.1:8318/v1. La clé est stockée sur le serveur et les réponses API n’affichent qu’une valeur masquée. Définissez le chemin de Blender dans les paramètres ou avec FACET_BLENDER.

04Lancer votre première manche

Créez une session, choisissez Blender, décrivez votre objectif en une phrase et ajoutez éventuellement une image de référence. Lancez la manche pour obtenir de vrais rendus Blender de plusieurs modèles, côte à côte.

05Choisir, poursuivre, créer une branche

Sélectionnez le résultat qui vous plaît. Votre choix met à jour le recueil de méthodes du logiciel et les classements Elo des modèles et des stratégies. Poursuivez à partir de ce résultat ou cliquez sur un résultat antérieur dans la filiation pour créer une branche à cet endroit.

06Images IA avec ima2

Le panneau AI Image utilise un serveur ima2-gen exécuté sur le même ordinateur. Facetion ne le démarre pas pour vous : exécutez d’abord ima2 start. L’adresse par défaut est http://127.0.0.1:3333 ; modifiez-la avec FACET_IMA2_URL ou dans le panneau. Seuls 127.0.0.1 et localhost sont acceptés.

07Autres logiciels

TouchDesigner nécessite la passerelle TDMCP et son fichier de configuration ; sans connexion, l’état est affiché et les manches sont bloquées. Unreal, Cinema 4D, After Effects et ComfyUI nécessitent chacun que le logiciel, le plugin ou la passerelle soit installé et prêt.

08Utiliser Facetion depuis un agent IA (MCP)

Démarrez d’abord le serveur Facetion, puis enregistrez ce processus dans votre hôte MCP. Les outils comprennent facet_status, facet_create_session, facet_start_round, facet_wait_round, facet_pick et facet_get_render.

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

09Variables d’environnement

FACET_PORT : port du serveur (5178 par défaut)
FACET_DATA_DIR : dossier de données (.facet-data dans la copie du code source par défaut)
FACET_BLENDER : chemin de Blender
FACET_IMA2_URL : adresse du serveur ima2

10À savoir

Le code Blender généré s’exécute dans un processus distinct avec un délai limite et un contrôle statique du code. Ce contrôle statique n’est pas un bac à sable au niveau du système d’exploitation.
La qualité des productions des modèles varie d’un résultat à l’autre. Consultez les notes visuelles et examinez vous-même les rendus.
L’interface et les logiciels s’exécutent sur votre ordinateur, mais les appels IA sont envoyés au fournisseur que vous configurez.
Les erreurs des modèles sont consignées dans le journal et sur les fiches de résultats.