garrytan/gbrain

GBrain – 개인 에이전트 메모리 데몬

그것이 무엇인가

GBrain은 LLM 기반 에이전트에 구조화되고 편집 가능한 메모리 저장소를 제공하는 자체 호스팅 서비스입니다. 사실(페이지)을 소스 URL과 함께 기록하고 항목을 수정하거나 철회할 수 있으며 해당 지식을 원시 청크, 합성 답변 또는 유형화된 지식 그래프로 표시할 수 있습니다.

주요 아이디어

명시적이고 출처가 풍부한 사실 – 모든 정보는 인용이 있는 페이지로 저장되므로 에이전트가 원본 소스를 가리킬 수 있습니다.
수정 및 철회 – 사실을 업데이트하거나 삭제할 수 있으며 시스템은 이러한 변경 사항을 추적합니다.
에이전트 간 공유 – 동일한 브레인을 여러 에이전트(예: Grok Bot, Muse, Claude Code, Codex)에 연결하면서 각 에이전트의 ID는 분리된 상태로 유지할 수 있습니다.
선택적 레이어 – 간단한 키워드 검색으로 시작하고 나중에 의미 검색, LLM 기반 합성(인용이 있는 답변) 또는 관계 쿼리를 위한 그래프 보기를 활성화합니다.
회사 브레인 모드 – 인증을 통해 원격 클라이언트는 부여된 권한 내에서만 읽기/쓰기가 가능하므로 공유 기업 지식 베이스로 사용할 수 있습니다.

사용 방법

기존 에이전트에 추가 – gbrain setup <harness> 명령(Claude Code, Codex, Grok Bot 등)을 실행합니다. 도구는 작은 런처를 에이전트에 주입하고 로컬 브레인 디렉토리를 생성하며 MCP(“메모리 클라이언트 프로토콜”)를 연결하여 에이전트가 remember, recall, correct 등을 호출할 수 있게 합니다.
독립 실행형 서비스로 실행 – gbrain init …은 MCP(예: Tailscale tailnet을 통해)로 노출할 수 있는 데몬을 생성합니다. 다른 머신이나 클라우드 에이전트는 *“mcp를 통해 내 브레인 사용”*이라고 말하여 연결할 수 있습니다.
호스팅 브레인 연결 – OAuth/개인 머신 흐름을 사용하여 원격 브레인을 클라우드 호스팅 하네스에 연결합니다.

일반적인 워크플로우

데몬은 데이터(이메일, 회의 노트, 트윗, 음성 기록 등)를 지속적으로 수집하고 밤새 강화합니다.
질문을 하면 에이전트가 브레인을 호출합니다:
- 키워드/의미 검색 → 관련 페이지를 반환합니다.
- 합성 레이어(선택 사항) → LLM이 간결한 답변을 구성하고 각 사실을 인용하며 브레인이 모르는 것을 알려주는 갭 분석 노트를 추가합니다.
- 그래프 어댑터(선택 사항) → *“Acme에서 누가 일하나요?”*와 같은 관계형 질문을 할 수 있으며 추가 LLM 호출 없이 저장된 엣지에서 파생된 답변을 얻을 수 있습니다.

왜 중요한가

“검색 후 읽기” 루프를 제거합니다: 브레인이 대신 읽고 요약합니다.
개인 또는 기업 지식의 단일 진실 소스를 제공하며 감사 가능한 출처를 갖습니다.
자체 하드웨어와 데이터에서 작동하므로 개인 정보 보호와 비용을 제어할 수 있습니다.

설치 스냅샷

# Bun을 통해 바이너리 설치(필요 버전 ≥ 1.4)
bun install -g github:garrytan/gbrain

# Claude Code(또는 Codex) 빠른 설정
gbrain setup claude-code   # 미리 보려면 --dry-run, 되돌리려면 --remove 추가

setup 명령은 브레인 디렉토리를 생성하고 MCP 후크를 작성하며 상태 점검(gbrain doctor)을 실행합니다.
순수 CLI 브레인(에이전트 없음)의 경우 다음을 실행할 수 있습니다:

gbrain init --pglite --no-embedding   # 키 없음, 로컬 SQLite 스타일 저장소
gbrain import ~/my-notes/ --no-embed  # markdown 파일 인덱싱

원격 노출: gbrain mcp expose(선택적으로 클라우드 에이전트용 --funnel)는 Tailscale 네트워크를 통해 데몬을 게시합니다.

지원되는 에이전트 / 통합

Grok Bot – 브레인을 머신에 유지하는 격리된 런처를 설치합니다.
Muse / Muse Code – 유사한 흐름으로, 기본 편집 가능 메모리에 GBrain의 휴대용 레이어를 추가합니다.
Claude Code 및 Codex – 플러그인 기반 설치(codex plugin add gbrain@gbrain 등)
OpenClaw / Hermes – 브레인이 서버에서 24/7 실행되는 풀스택 배포.
MCP 호환 클라이언트 – Cursor, Windsurf, 사용자 정의 stdio 도구는 MCP 구성에 gbrain 명령을 추가할 수 있습니다.

성능 힌트

내장 벤치마크(BrainBench)는 그래프 어댑터가 관계 쿼리의 정밀도/재현율을 향상시킨다는 것을 보여줍니다(P@5 0.342 대 0.192, 일반 하이브리드 검색 대비).

안전 및 제한 사항

브레인은 원격 호출자가 로컬 파일을 볼 수 없음을 보장하지 않습니다. 권한은 소스 및 작업별로 적용됩니다.
데몬은 npm으로 배포되지 않습니다 – 잘못된 gbrain 패키지를 설치하면 실제 바이너리를 가릴 수 있습니다. README는 Bun 기반 설치만 사용하도록 경고합니다.

결론 GBrain은 LLM 에이전트를 위한 프로덕션 등급의 자체 호스팅 메모리 레이어입니다. 검색 가능하고 인용이 지원되는 지식 베이스를 제어 하에 유지하고 개인 또는 기업 에이전트 간에 공유하며 선택적으로 LLM 생성 답변이나 그래프 스타일 쿼리를 자체 인프라를 떠나지 않고 얻을 수 있습니다.

garrytan/gbrain

GBrain – 개인 에이전트 메모리 데몬

관련