빠른 시작

01필수 환경

• Bun 1.4
• Blender 5.2 (현장 테스트에는 5.2.2 LTS 사용)
• OpenAI 호환 AI 제공업체 URL 및 API 키
• 선택 사항: AI 이미지용 ima2-gen, TouchDesigner용 TDMCP 브리지, Unreal MCP를 사용하는 Unreal Engine 5.8

02설치와 실행

체크아웃한 소스의 앱 폴더에서 의존성을 설치하고 서버를 시작한 뒤, 브라우저에서 인터페이스를 여세요.

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

03제공업체와 Blender 연결

설정을 열어 OpenAI 호환 제공업체 주소와 API 키를 입력하세요. 기본 주소는 http://127.0.0.1:8318/v1입니다. 키는 서버에 저장되며 API 응답에는 마스킹된 값만 표시됩니다. 설정이나 FACET_BLENDER로 Blender 경로를 지정하세요.

04첫 라운드 실행

새 세션을 만들고 Blender를 선택한 뒤 목표 문장을 작성하세요. 레퍼런스 이미지는 선택적으로 추가할 수 있습니다. 라운드를 실행하면 여러 모델이 만든 실제 Blender 렌더를 나란히 볼 수 있습니다.

05선택, 이어가기, 분기

마음에 드는 결과를 선택하세요. 선택하면 해당 프로그램의 플레이북과 모델 및 전략 Elo가 갱신됩니다. 그 결과에서 이어가거나, 계보에서 이전 결과를 클릭해 분기할 수 있습니다.

06ima2로 AI 이미지 만들기

AI 이미지 패널은 같은 컴퓨터에서 실행 중인 ima2-gen 서버를 사용합니다. Facetion이 대신 시작해 주지 않으므로 먼저 ima2 start를 실행하세요. 기본 주소는 http://127.0.0.1:3333이며, FACET_IMA2_URL이나 패널에서 변경할 수 있습니다. 127.0.0.1과 localhost만 허용됩니다.

07다른 프로그램

TouchDesigner에는 TDMCP 브리지와 설정 파일이 필요합니다. 연결되지 않으면 상태가 표시되고 라운드는 실행할 수 없습니다. Unreal, Cinema 4D, After Effects, ComfyUI는 각각 프로그램, 플러그인 또는 브리지가 설치되어 실행 가능한 상태여야 합니다.

08AI 에이전트에서 Facetion 사용 (MCP)

먼저 Facetion 서버를 시작한 뒤 MCP 호스트에 이 프로세스를 등록하세요. 도구에는 facet_status, facet_create_session, facet_start_round, facet_wait_round, facet_pick, facet_get_render가 포함됩니다.

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

09환경 변수

• FACET_PORT: 서버 포트 (기본값 5178)
• FACET_DATA_DIR: 데이터 디렉터리 (기본값: 체크아웃 경로의 .facet-data)
• FACET_BLENDER: Blender 경로
• FACET_IMA2_URL: ima2 서버 주소

10알아둘 사항

• 생성된 Blender 코드는 시간 제한과 정적 코드 검사를 적용한 별도 프로세스에서 실행됩니다. 정적 코드 검사는 운영체제 샌드박스가 아닙니다.
• 모델 출력 품질은 결과마다 다릅니다. 비전 평가 점수를 확인하고 렌더도 직접 살펴보세요.
• 인터페이스와 프로그램은 자신의 컴퓨터에서 실행되지만 AI 호출은 설정한 제공업체로 전송됩니다.
• 모델 오류는 실행 기록과 결과 카드에 기록됩니다.