React, Angular, Vue 및 채팅 앱에서 생성형 UI, 공유 상태, 휴먼 인 더 루프 흐름을 갖춘 에이전트 네이티브 앱을 구축하는 TypeScript SDK입니다.
XiaoLuoLYG/GOD
LLM 에이전트 사회 시뮬레이션을 실행하는 브라우저 기반 제어실로, 가상 마을을 단계별로 일시 정지하고 질문을 보내고 방향을 조정하거나 다시 재생할 수 있습니다.
- 스타
- 1,228
- 포크
- 136
- 열린 이슈
- 9
- 마지막 커밋
- 18일 전
어떤 프로젝트인가요?
GOD는 언어 모델 에이전트 사회 시뮬레이션을 위한 로컬 제어실입니다. 시뮬레이션이 진행되는 모습을 지켜보기만 하는 대신, 어느 단계에서든 멈추고 재생을 탐색하거나 자동 재생할 수 있습니다. 주민 한 명이나 그룹, 마을 전체에 질문을 보내고, 에이전트가 다음 차례에 읽을 지시를 입력할 수도 있습니다.
이 프로젝트는 로컬 FastAPI 백엔드, React/Vite 브라우저 UI, 그리고 로컬 WebSocket으로 연결되는 별도 프로세스의 에이전트 런타임으로 구성됩니다. 설정 마법사에서 OpenAI 호환 모델 엔드포인트, 시나리오, 에이전트 프로필을 구성한 뒤 실험을 시작할 수 있습니다. 실험, 지도, 에이전트 세트는 ZIP 팩으로 내보내고 가져올 수 있습니다.
Tiled 기반 픽셀 마을과 PKU 캠퍼스 지도를 사용하는 기본 실험 두 가지가 제공됩니다. 또한 설치나 API 키가 필요 없는 브라우저 전용 리플레이를 GitHub Pages에서 이용할 수 있습니다.
핵심 기능
- 01실시간 또는 녹화된 시뮬레이션을 단계별로 일시 정지하고 탐색하거나 자동 재생합니다.
- 02진행 중에 에이전트 한 명이나 그룹, 마을 전체에 질문을 보냅니다.
- 03에이전트가 다음 차례에 읽을 지시를 입력합니다.
- 04모델, 시나리오, 에이전트 생성을 위한 브라우저 설정 마법사입니다.
- 05지도와 주민을 편집할 수 있는 Map Studio와 Agent Studio입니다.
- 06실험, 지도, 에이전트 팩을 ZIP 파일로 가져오고 내보냅니다.
활용 사례
- 스크립트로 구성한 사회 시나리오에서 LLM 에이전트가 어떻게 행동하는지 살펴봅니다.
- 개입이 시뮬레이션된 공동체의 결과를 단계별로 어떻게 바꾸는지 테스트합니다.
- 재현 가능한 에이전트 시뮬레이션을 다운로드 가능한 팩으로 공유합니다.
- 에이전트 기반 실험을 위한 맞춤형 지도와 주민 프로필을 프로토타이핑합니다.
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/XiaoLuoLYG/GOD.git - 2
프로젝트 디렉터리로 이동합니다
cd GOD - 3
GOD를 시작합니다(macOS/Linux). 브라우저에서 설정 마법사가 열립니다
./scripts/god.sh start
사용 전 알아둘 점
- 로컬에서 실행하려면 OpenAI 호환 모델 API 키와 엔드포인트가 필요하며, 설정 마법사에서 이를 요청합니다.
- README에는 별도의 명령을 사용해 PowerShell 런처로 Windows에서 시작하는 방법도 설명되어 있습니다.
- README에 따르면 이 도구는 언어 에이전트 사회를 살펴보기 위한 것이며, 그 사회가 사회적으로 현실적이라고 주장하기 위한 것은 아닙니다.
토픽
자주 묻는 질문
- GOD은(는) 무엇인가요?
- LLM 에이전트 사회 시뮬레이션을 실행하는 브라우저 기반 제어실로, 가상 마을을 단계별로 일시 정지하고 질문을 보내고 방향을 조정하거나 다시 재생할 수 있습니다. GOD는 언어 모델 에이전트 사회 시뮬레이션을 위한 로컬 제어실입니다. 시뮬레이션이 진행되는 모습을 지켜보기만 하는 대신, 어느 단계에서든 멈추고 재생을 탐색하거나 자동 재생할 수 있습니다. 주민 한 명이나 그룹, 마을 전체에 질문을 보내고, 에이전트가 다음 차례에 읽을 지시를 입력할 수도 있습니다.
- GOD은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- GOD은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- GOD은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. GOD의 마지막 커밋은 2026년 10월 2일입니다.
- GOD은(는) 어디에 사용할 수 있나요?
- 스크립트로 구성한 사회 시나리오에서 LLM 에이전트가 어떻게 행동하는지 살펴봅니다. 개입이 시뮬레이션된 공동체의 결과를 단계별로 어떻게 바꾸는지 테스트합니다. 재현 가능한 에이전트 시뮬레이션을 다운로드 가능한 팩으로 공유합니다. 에이전트 기반 실험을 위한 맞춤형 지도와 주민 프로필을 프로토타이핑합니다.
- GOD는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/XiaoLuoLYG/GOD.git 프로젝트 디렉터리로 이동합니다: cd GOD GOD를 시작합니다(macOS/Linux). 브라우저에서 설정 마법사가 열립니다: ./scripts/god.sh start
- GOD은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/XiaoLuoLYG/GOD
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
도구, 메모리, 데이터 생성 기능을 갖춘 LLM 기반 에이전트를 구축하고 시뮬레이션하며 연구할 수 있는 Python 멀티 에이전트 프레임워크입니다.
JavaScript 및 Python SDK를 제공해 AI 생성 코드를 격리된 클라우드 샌드박스에서 실행하는 오픈소스 인프라입니다.
LLM이 자체 컴포넌트 라이브러리로 렌더링 가능한 UI를 생성하도록 지원하는 OpenUI Lang 기반 프레임워크 독립형 Generative UI 툴킷
LangGraph 기반의 모듈형 Agentic RAG 튜토리얼로, 계층형 인덱싱과 대화 메모리, 질의 명확화 기능을 제공합니다.
AI 에이전트와 워크플로를 시각적으로 구축하고 테스트·배포하며, API와 MCP 서버로 바로 노출할 수 있는 플랫폼입니다.