Godot AI? 이 해결책을 가져왔습니다: Golem-AI란 무엇인가?

Godot에서 게임을 개발하며 프로그래밍을 위해 인공지능 (AI)을 사용하고 있다면, 에디터와 웹 브라우저 사이를 계속해서 창 전환하며 작업하는 것에 분명 지쳤을 것입니다. 코드를 복사하고, 붙여넣고, 장면 (scenes)의 컨텍스트를 매번 반복해서 설명하는 것... 이는 매우 번거로운 일입니다.

이를 해결하기 위해, 저는 Golem-AI를 만들었습니다 (Godot의 로고가 작은 기계 골렘처럼 보이기 때문에 붙여진 이름입니다). 이것은 Godot 4.2+ 에디터 내부의 독 (dock)에 직접 통합된 "Cursor" 스타일의 AI 어시스턴트입니다.

오늘 저는 이 저장소 (repository)를 완전한 오픈 소스 (open-source) 프로젝트로 공개합니다. 현재 베타 (Beta) 단계이며 버그가 존재하지만, 이미 완전히 기능하며 커뮤니티와 함께 개선해 나가기 위해 공유하고자 합니다.

  / ____/___  / /__  ____ ___        /   |  /  _/
 / / __/ __ \/ / _ \/ __ `__ \______/ /| |  / /  
/ /_/ / /_/ / /  __/ / / / / /_____/ ___ |_/ /   
...

🔥 주요 특징
🦙 로컬 및 클라우드 모델 (Local and Cloud Models): Ollama 또는 LM Studio에 연결하여 100% 무료 및 오프라인 워크플로우를 사용하거나, OpenAI, Anthropic, Gemini 또는 Cursor 프록시 (proxies)로 설정할 수 있습니다.

🧠 @ 멘션(Mentions)을 통한 컨텍스트 (Cursor 스타일): 채팅에서 @를 입력하여 열려 있는 장면 (scenes), 프로젝트의 특정 파일 또는 사용자 정의 스킬 (customized skills)을 프롬프트 (prompt)에 직접 자동으로 첨부할 수 있습니다.

🛠️ 에디터 도구 호출 (Tool Calling): AI가 Godot의 네이티브 도구와 상호 작용하여 더 빠르게 반복 작업을 수행할 수 있도록 돕는 선택적 다단계 검증 루프를 갖추고 있습니다.

📚 마크다운 (Markdown) 기반 스킬 시스템: 표준 마크다운 파일 (/skill 또는 @skill:id)을 사용하여 특정 워크플로우로 어시스턴트를 학습시킬 수 있습니다.

💬 고급 채팅 UI: 사고 블록 (thinking blocks), 에이전트 (agent) 단계 진행 상황, 검색 기능이 포함된 세션 기록 및 기본 이중 언어 인터페이스 (스페인어 / 영어)를 포함합니다.

🛠️ 현재 상태: "작동은 하지만..." (베타 테스터 모집!)
투명하게 말씀드리겠습니다: 이것은 베타 (Beta) 버전입니다.

오류를 발견할 수도 있습니다. 도구 실행 루프 (tool execution loop)가 가끔 실패하거나, 작은 로컬 모델 (local model)이 노드 (nodes) 구조에 대해 환각 (hallucination)을 일으킬 수 있습니다. 하지만 바로 그렇기 때문에 오늘 이를 공개적으로 공유하는 것입니다. 다양한 워크플로우 (workflows)에서 어떻게 작동하는지, 대규모 프로젝트를 어떻게 처리하는지, 그리고 Godot 커뮤니티가 통합된 AI 동료에게 진정으로 원하는 것이 무엇인지 확인하고 싶습니다.

🚀 빠른 시작 가이드
테스트해 보거나 이것을 망가뜨려 보는 데 2분도 채 걸리지 않습니다.

1. 설치
   Godot 프로젝트의 addons 폴더 내에 리포지토리 (repository)를 직접 클론 (clone) 하세요:

git clone https://github.com/sancheznot/Godot-AI-Assistant.git addons/ai_assistant_plugin

2. 플러그인 활성화
   Godot에서 프로젝트를 열고, 프로젝트(Project) -> 프로젝트 설정(Project Settings) -> 플러그인(Plugins)으로 이동하여 AI Assistant Plugin 옆의 활성화 (Enable) 체크박스를 선택하세요.

3. 모델 설정
   새로운 패널 (dock)의 툴바에 있는 설정 (Config) 버튼을 클릭하고, 선호하는 제공자 (provider, 예: Ollama)를 활성화한 다음, 새로고침 ↻ 아이콘을 눌러 로컬 또는 클라우드에 저장된 모델을 불러오면 끝입니다!

🤝 협업하기 (기여하기)
코드 구조는 상당히 깔끔하고 모듈식 (modular)입니다:

/harness는 프롬프트 시스템 (prompt system)의 레이어를 관리합니다.

/scenes 및 /scripts는 도크 (dock) 인터페이스와 플러그인 로직을 분리합니다.

/skills는 Markdown 형식으로 사전 설정된 동작들을 포함합니다.

GDScript 개발자이거나, AI 아키텍처 (architecture) 애호가이거나, 혹은 단순히 시각적 인터페이스를 다듬는 것을 좋아한다면, 풀 리퀘스트 (Pull Requests)와 이슈 (Issues)는 언제나 환영입니다.

👉 GitHub 리포지토리 링크: https://github.com/sancheznot/Godot-AI-Assistant

직접 사용해 보셨다면, 아래 댓글로 어떠셨는지 알려주세요! 어떤 제공자 (provider)를 사용 중이신가요? 가장 먼저 무엇이 고장 났나요? 우리 모두 함께 Godot의 Golem을 더 똑똑하게 만들어 봅시다.