TL;DR

브라우저에서 Gemini API를 직접 호출해 5명의 AI 에이전트가 라운드 기반으로 토론하고 투표해 서로를 제거하는 인터랙티브 데스게임을 제공한다. 사용자는 게임마스터로서 토론 중간에 텍스트 지시를 입력하거나 강제 퇴장·추가 투표 권한을 행사할 수 있으며 모든 호출은 클라이언트에서 직접 외부 모델로 전송되어 서버 인프라와 중앙 키 저장소가 필요 없다. 모델 우선순위로 gemini-3-flash-preview를 사용하고 실패 시 gemini-2.5-flash로 폴백하도록 구성되어 있으며 모델 교체는 lib/byokClient.ts 상수 편집으로 가능하다. 이 구조는 즉시 체험 가능한 데모와 낮은 운영 비용을 제공하는 대신 클라이언트 네트워크 상태와 API 요금에 직접 의존하는 트레이드오프가 있다. 로컬 개발은 git clone 이후 npm install과 npm run dev로 즉시 시작할 수 있다.

주요 기능

• 브라우저에서 Gemini API로 직접 추론을 실행한다.
• 게임마스터로 텍스트 지시를 토론 중간에 주입하고 추가 투표나 강제 퇴장 권한을 행사할 수 있다.
• 라운드 기반 토론·투표·퇴장 규칙을 구현해 에이전트 간 심리전과 상호작용을 재현한다.
• 트로피 시스템과 숨겨진 캐릭터 잠금 해제로 반복 플레이에 대한 진척을 제공한다.

어떻게 동작하는가

클라이언트는 브라우저에서 @google/genai SDK를 통해 Gemini 모델에 직접 요청을 전송하고 응답으로 에이전트 발언을 생성한다. 게임 진행은 로컬에서 토론 라운드와 투표 결과를 계산하며 GM의 지시 입력은 중간에 텍스트로 전달되어 각 에이전트의 응답에 반영된다. 모델 선택은 README에 적힌 상위 모델을 우선 사용하고 실패 시 정의된 폴백 모델로 전환하는 방식으로 구성되어 있어 lib/byokClient.ts 상수로 모델을 교체할 수 있다.

해결 문제

멀티 에이전트 상호작용과 인간 개입을 결합한 인터랙티브 시뮬레이션을 서버 없이도 즉시 체험할 수 있는 환경을 제공한다. 이 프로젝트는 중앙 서버에 API 키를 보관하지 않고 브라우저에서 직접 외부 LLM을 호출하는 구조로, 서버 운영 비용과 키 보안 부담을 제거했다. 또한 게임마스터 권한을 통해 사용자가 토론 전개를 실시간으로 바꿔 에이전트 행동을 관찰하고 실험할 수 있게 한다.

지금 주목받는 이유

브라우저 기반으로 Gemini 모델을 직접 체험하면서 즉시 상호작용 가능한 인터랙티브 데모를 제공하기 때문에 주목받고 있다.

차별점

• 서버 없이 브라우저에서 직접 Gemini API에 요청을 보내는 BYOK 구조를 채택해 별도 서버 인프라가 필요 없다.
• 실시간 GM 개입 기능으로 사용자가 토론 중간에 텍스트 지시를 주입하거나 강제 퇴장·추가 투표를 실행할 수 있게 설계되었다.
• Primary 모델과 폴백 모델을 README에 명시해 실패 시 자동 전환 정책을 적용하도록 구현된 점이 명확히 드러난다.

사용 사례

• LLM 기반 멀티에이전트 상호작용을 시각적으로 관찰하는 데모 및 실험 환경으로 사용한다.
• 프롬프트 설계와 에이전트 거버넌스 효과를 즉석에서 확인하는 인터랙티브 테스트베드로 활용한다.
• 간단한 엔터테인먼트형 웹 게임으로 플레이어가 게임마스터 권한을 통해 다양한 시나리오를 시험하는 목적에 적합하다.

시작하기

레포지토리를 클론한 뒤 npm install을 실행하고 npm run dev로 개발 서버를 기동한다. 브라우저에서 http://localhost:3000 을 열고 Gemini API 키를 입력하면 게임을 시작할 수 있다. Vercel에 임포트하면 서버 처리 없이 정적 사이트 수준의 비용으로 배포해 운영할 수 있다.

요구사항

• Node.js 런타임과 npm이 설치된 개발 환경
• 브라우저에서 동작 가능한 환경(최신 Chromium 기반 브라우저 권장)
• 사용자 소유의 Gemini API 키와 @google/genai SDK에 대한 접근 권한

이미지 분석