Repolode
garrytan

garrytan/gbrain

AI 에이전트를 위한 셀프 호스팅 메모리 계층으로, 출처가 명시된 사실을 저장하고 여러 에이전트와 MCP 클라이언트, CLI가 하나의 브레인을 공유합니다.

스타
31,577
포크
4,705
열린 이슈
566
마지막 커밋
20시간 전

어떤 프로젝트인가요?

GBrain은 직접 관리할 수 있는 영구 메모리를 AI 에이전트에 제공합니다. 사실을 출처와 함께 Markdown 페이지로 저장하고, 사실을 수정하거나 철회할 수 있으며, MCP 또는 CLI를 통해 여러 에이전트가 동일한 브레인을 사용하도록 합니다. 키 설정 없이 PGLite에서 로컬로 키워드 검색을 실행할 수 있습니다. 시맨틱 검색, 종합 답변 생성, 백그라운드 보강 기능은 선택 사항이며 임베딩 또는 모델 제공자를 설정해야 합니다.

GBrain은 검색 기능 외에도 신뢰할 수 있는 로컬 페이지 쓰기를 바탕으로 타입이 지정된 지식 그래프를 구축해, 특정 회사에서 일하는 사람이 누구인지와 같은 관계 질문에 답할 수 있습니다. 선택 사항인 종합 답변 계층은 인용이 포함된 답변을 제공하고 브레인이 알고 있는 내용의 공백을 알려줍니다. 예약 작업을 설정하면 자리를 비운 동안 페이지를 가져오고, 중복을 제거하고, 내용을 통합할 수 있습니다.

이 프로젝트는 Claude Code, Codex, Cursor 같은 코딩 에이전트나 OpenClaw, Hermes 같은 상시 실행되는 개인 에이전트를 사용하는 개발자를 대상으로 합니다. 개인용으로 로컬 PGLite 데이터베이스를, 공유 환경이나 대규모 배포에는 pgvector를 사용하는 Postgres를 지원하며, OAuth와 범위 지정 액세스 기능을 갖춘 원격 MCP 서버도 제공합니다.

핵심 기능

  • 01출처가 명시된 사실을 저장하고 수정 및 철회를 지원합니다.
  • 02로컬 PGLite와 키워드 검색을 키 설정 없이 사용할 수 있으며, 시맨틱 검색은 선택 사항입니다.
  • 03stdio 또는 HTTP를 통한 MCP와 CLI로 여러 에이전트가 하나의 브레인을 사용할 수 있습니다.
  • 04신뢰할 수 있는 로컬 페이지 쓰기를 바탕으로 타입이 지정된 지식 그래프를 구축해 관계를 질의할 수 있습니다.
  • 05선택 사항인 종합 답변 명령으로 인용이 포함된 답변을 제공하고 지식의 공백을 알려줍니다.
  • 06공유 환경이나 대규모 배포에 pgvector를 사용하는 Postgres를 지원합니다.

활용 사례

  • Claude Code 또는 Codex 코딩 에이전트에 세션 간 지속되는 메모리를 제공합니다.
  • 팀의 여러 AI 클라이언트가 하나의 검색 가능한 지식 베이스를 공유합니다.
  • 메모, 연락처, 회의 기록을 관리하는 상시 실행 개인 에이전트를 운영합니다.
  • Markdown 메모에 저장된 사람, 회사, 거래 간의 관계를 질의합니다.

빠른 시작

  1. 1

    Bun으로 GBrain 설치(Bun 1.4.0 이상 필요, npm에서는 배포되지 않음)

    bun install -g github:garrytan/gbrain
  2. 2

    Claude Code용으로 GBrain 설정(대신 codex로 실행해도 됨)

    gbrain setup claude-code

사용 전 알아둘 점

  • Bun 1.4.0 이상이 필요합니다.
  • npm에서는 배포되지 않으며, gbrain이라는 이름의 npm 패키지는 관련이 없는 패키지로 실제 바이너리를 가릴 수 있습니다.
  • 상시 운영하려면 RAM 8GB 이상을 갖춘 배포 서버와 지속적인 API 토큰 비용이 필요합니다.
  • 시맨틱 검색, 종합 및 보강 기능에는 클라우드 제공업체 또는 별도로 설정한 모델 API 키가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

gbrain은(는) 무엇인가요?
AI 에이전트를 위한 셀프 호스팅 메모리 계층으로, 출처가 명시된 사실을 저장하고 여러 에이전트와 MCP 클라이언트, CLI가 하나의 브레인을 공유합니다. GBrain은 직접 관리할 수 있는 영구 메모리를 AI 에이전트에 제공합니다. 사실을 출처와 함께 Markdown 페이지로 저장하고, 사실을 수정하거나 철회할 수 있으며, MCP 또는 CLI를 통해 여러 에이전트가 동일한 브레인을 사용하도록 합니다. 키 설정 없이 PGLite에서 로컬로 키워드 검색을 실행할 수 있습니다. 시맨틱 검색, 종합 답변 생성, 백그라운드 보강 기능은 선택 사항이며 임베딩 또는 모델 제공자를 설정해야 합니다.
gbrain은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
gbrain은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
gbrain은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. gbrain의 마지막 커밋은 2026년 11월 6일입니다.
gbrain은(는) 어디에 사용할 수 있나요?
Claude Code 또는 Codex 코딩 에이전트에 세션 간 지속되는 메모리를 제공합니다. 팀의 여러 AI 클라이언트가 하나의 검색 가능한 지식 베이스를 공유합니다. 메모, 연락처, 회의 기록을 관리하는 상시 실행 개인 에이전트를 운영합니다. Markdown 메모에 저장된 사람, 회사, 거래 간의 관계를 질의합니다.
gbrain는 어떻게 설치하나요?
Bun으로 GBrain 설치(Bun 1.4.0 이상 필요, npm에서는 배포되지 않음): bun install -g github:garrytan/gbrain Claude Code용으로 GBrain 설정(대신 codex로 실행해도 됨): gbrain setup claude-code
gbrain은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/garrytan/gbrain

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트