StrandedBot: Ollama 기반 로컬 LLM 자율 에이전트 서바이벌 게임

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

StrandedBot은 로컬 환경에서 실행되는 LLM이 고립된 행성의 로봇을 조종하는 서바이벌 게임 프로젝트이다. Pygame Zero를 기반으로 구축되었으며 Ollama를 통해 LLM이 게임 내 도구를 호출하고 전략을 수립하여 자율적으로 플레이한다. 사용자는 모델을 선택하고 프롬프트를 수정하거나 인터랙티브 모드를 통해 로봇과 소통할 수 있다. 이 프로젝트는 로컬 LLM의 의사결정 능력과 도구 호출 기능을 실제 게임 환경에서 테스트하는 훌륭한 사례이다.

배경

Python 3.12 이상, Ollama 설치 및 실행 환경, Poetry 패키지 관리자 지식

대상 독자

LLM 에이전트 및 자율 주행 AI 개발자

의미 / 영향

이 프로젝트는 고성능 GPU 서버 없이도 로컬 환경에서 복잡한 자율 에이전트를 구현할 수 있음을 보여준다. 특히 도구 호출 기능을 게임이라는 동적인 환경에 적용함으로써 에이전트의 실시간 상황 판단 능력을 고도화하는 연구에 기여할 수 있다.

섹션별 상세

Ollama를 활용한 로컬 LLM 자율 주행 모드를 지원한다. OLLAMA_PLAY 환경 변수를 활성화하면 LLM이 로봇을 직접 조종하며 기본 모델로 Ministral-3:8b를 사용한다. 사용자는 게임 시작 시 로봇의 미션 프롬프트를 직접 편집하거나 인터랙티브 모드를 통해 로봇의 질문에 답변하며 협력 플레이를 진행할 수 있다.

로봇 캐릭터, 타일 맵, 그리고 각종 상태 정보와 로그가 표시된 게임 실행 화면이다. — ScreenshotLLM이 조종하는 로봇의 현재 위치, 에너지 상태, 태양 플레어 카운트다운 등을 보여주는 UI 창들이 배치되어 있다. 오른쪽 하단의 Bot Speech 창을 통해 LLM이 현재 상황을 어떻게 요약하고 다음 단계를 계획하는지 실시간으로 확인할 수 있다.

게임 시작 시 LLM 모델과 프롬프트 모드를 선택하는 설정 화면이다. — Screenshot사용자가 Ollama에서 실행할 모델(예: ministral-3:8b)을 지정하고 기본 프롬프트 또는 커스텀 프롬프트를 선택할 수 있는 인터페이스를 보여준다. 인터랙티브 모드 활성화 여부를 결정하여 사용자와 AI의 협력 방식을 설정할 수 있음을 나타낸다.

게임 메커니즘은 태양 플레어 위협과 자원 관리를 중심으로 설계되었다. 20시간마다 발생하는 태양 플레어로부터 살아남기 위해 서식지를 수리하고 에너지를 관리해야 한다. 지형 생성, 시야 계산, 서식지 손상 추적 등 복잡한 게임 상태가 Python으로 구현되어 LLM에게 실시간으로 전달된다.

LLM은 6가지 정의된 도구 호출 스키마를 통해 게임 환경과 상호작용한다. MoveTo, LookClose, LookFar, Dig, Create 등의 액션을 사용하여 지형을 탐색하고 자원을 채굴하며 구조물을 건설한다. 각 액션은 시간 기반으로 실행되며 LLM은 현재 상태와 목표를 분석하여 최적의 도구를 선택한다.

시스템 아키텍처는 기능별로 철저히 모듈화되어 있다. 게임 로직을 담당하는 game_logic.py, 렌더링을 처리하는 rendering.py, Ollama 연동을 관리하는 ollama_agent.py 등으로 나뉜다. 특히 sys.stdout을 가로채어 게임 내 UI 창에 실시간 로그를 출력하는 구조를 통해 에이전트의 사고 과정을 시각적으로 모니터링할 수 있다.

실무 Takeaway

Ollama와 Pygame Zero를 결합하여 로컬 환경에서도 지연 시간이 적은 LLM 에이전트 실험 환경을 구축할 수 있다
LLM 에이전트에게 명확한 도구 스키마를 제공함으로써 복잡한 게임 환경 내에서의 의사결정 능력을 효과적으로 테스트할 수 있다
환경 변수와 프롬프트 수정을 통해 다양한 LLM 모델의 게임 플레이 성능을 비교 분석하는 벤치마크 도구로 활용 가능하다

언급된 리소스

GitHubStrandedBot GitHub Repository