Doku

Schnellstart

Facetion läuft lokal auf deinem eigenen Rechner aus dem App-Ordner. Diese Anleitung führt dich von der Installation bis zur ersten Arena-Runde.

Befehle und Umgebungsvariablen verwenden weiterhin den internen Namen facet / FACET_.

01Voraussetzungen

Bun 1.4
Blender 5.2 (Praxistests nutzten 5.2.2 LTS)
URL und API-Schlüssel eines OpenAI-kompatiblen KI-Anbieters
Optional: ima2-gen für KI-Bilder, die TDMCP-Bridge für TouchDesigner, Unreal Engine 5.8 mit Unreal MCP

02Installieren und starten

Installiere im App-Ordner deines Checkouts die Abhängigkeiten und starte den Server. Öffne dann die Oberfläche im Browser.

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

03Anbieter und Blender verbinden

Öffne die Einstellungen und trage die Adresse und den API-Schlüssel deines OpenAI-kompatiblen Anbieters ein. Die Standardadresse ist http://127.0.0.1:8318/v1. Der Schlüssel wird auf dem Server gespeichert; API-Antworten zeigen nur einen maskierten Wert. Setze den Blender-Pfad in den Einstellungen oder mit FACET_BLENDER.

04Deine erste Runde

Erstelle eine neue Sitzung, wähle Blender, formuliere dein Ziel in einem Satz und füge optional ein Referenzbild hinzu. Starte die Runde, um echte Blender-Renderings mehrerer Modelle nebeneinander zu erhalten.

05Wählen und weitermachen

Wähle das Ergebnis, das dir gefällt. Die Auswahl aktualisiert das Playbook des Programms sowie die Elo-Werte der Modelle und Strategien. Mach damit weiter oder klicke im Verlauf auf ein früheres Ergebnis, um dort einen Abzweig zu beginnen.

06KI-Bilder mit ima2

Das Panel für KI-Bilder nutzt einen ima2-gen-Server auf demselben Rechner. Facetion startet ihn nicht für dich; führe zuerst ima2 start aus. Die Standardadresse ist http://127.0.0.1:3333; ändere sie mit FACET_IMA2_URL oder im Panel. Nur 127.0.0.1 und localhost werden akzeptiert.

07Weitere Programme

TouchDesigner benötigt die TDMCP-Bridge und ihre Konfigurationsdatei. Ohne Verbindung wird der Status angezeigt und Runden sind gesperrt. Für Unreal, Cinema 4D, After Effects und ComfyUI muss jeweils das Programm, Plugin oder die Bridge installiert und einsatzbereit sein.

08KI-Agenten anbinden (MCP)

Starte zuerst den Facetion-Server und registriere dann diesen Prozess in deinem MCP-Host. Zu den Tools gehören facet_status, facet_create_session, facet_start_round, facet_wait_round, facet_pick und facet_get_render.

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

09Umgebungsvariablen

FACET_PORT: Server-Port (Standard 5178)
FACET_DATA_DIR: Datenverzeichnis (Standard .facet-data im Checkout)
FACET_BLENDER: Pfad zu Blender
FACET_IMA2_URL: ima2-Serveradresse

10Gut zu wissen

Generierter Blender-Code läuft in einem separaten Prozess mit Zeitlimit und statischer Code-Prüfung. Diese Prüfung ist keine Sandbox auf Betriebssystemebene.
Die Qualität der Modellausgaben variiert von Ergebnis zu Ergebnis. Prüfe die visuellen Bewertungen und sieh dir die Renderings selbst an.
Oberfläche und Programme laufen auf deinem Rechner, KI-Aufrufe gehen jedoch an den von dir konfigurierten Anbieter.
Modellfehler werden im Protokoll und auf den Ergebniskarten festgehalten.