GBrain

GBrain — опинионированная система памяти для AI-агентов, созданная Гарри Таном. Хранит явные факты с указанием источников, поддерживает исправления и отзыв данных. Предоставляет синтезированные ответы с цитатами и анализом пробелов в знаниях. Может использоваться как персональный или командный мозг, подключается к агентам через MCP.

Категории: ,

GBrain — опинионированная система памяти для AI-агентов, созданная Гарри Таном. Хранит явные факты с указанием источников, поддерживает исправления и отзыв данных. Предоставляет синтезированные ответы с цитатами и анализом пробелов в знаниях. Может использоваться как персональный или командный мозг, подключается к агентам через MCP.

Назначение

GBrain добавляет агентам управляемую долговременную память. Каждый сохранённый факт снабжается ссылкой на источник, допускает корректировку и отзыв. Одна и та же память доступна разным агентам — от локального Claude Code до серверного OpenClaw. Начать можно с ключевого поиска без привлечения языковых моделей; семантический поиск, синтез ответов и фоновое обогащение подключаются по мере необходимости.

Как устроена память

  • Явные факты с происхождением. Каждая запись хранит исходную страницу, что позволяет проверить утверждение и при необходимости исправить или удалить его.
  • Два режима доступа. gbrain search возвращает ранжированный список страниц гибридным поиском (векторный + ключевой + RRF + бустинг по источнику + реранкер). gbrain think на основе тех же результатов формирует связный ответ с цитатами и честным анализом пробелов: что мозгу известно, что устарело, какие данные противоречат друг другу, чего не хватает.
  • Типизированный граф знаний. При локальной записи страниц автоматически извлекаются связи между сущностями (люди, компании) без вызова LLM.
  • Цикл обогащения. Фоновые cron-задачи могут обогащать записи, исправлять цитирование и консолидировать память, пока агент не активен.

Подключение к агентам

GBrain общается с агентами по протоколу MCP. Поддерживаются:

  • Локальные агенты через stdio (Claude Code, Codex, Cursor, Windsurf).
  • Удалённые агенты через HTTP с OAuth 2.1 (ChatGPT, Claude Desktop, Perplexity).
  • Публикация собственного сервера через Tailscale (gbrain mcp expose) для доступа из облачных сред.

Для быстрого старта с существующим агентом достаточно выполнить gbrain setup claude-code (или codex). Агенты Grok Bot и Muse подключаются по отдельным инструкциям. Хостинговая версия gbrain.io избавляет от необходимости что-либо устанавливать и поддерживать.

Установка и требования

GBrain не распространяется через npm. Установка выполняется командой bun install -g github:garrytan/gbrain. Требуется Bun 1.4.0 или новее. Локальное хранилище по умолчанию использует PGLite (WASM-сборка PostgreSQL 17), для крупных инсталляций доступен полноценный PostgreSQL с pgvector.

Ограничения

  • Экспорт в Markdown не является полной резервной копией базы данных. Для полноценного восстановления требуется отдельное резервное копирование СУБД.
  • Удалённые клиенты ограничены грантами на источники и операции, а также фильтрами видимости. Локальные файлы и общие учётные данные базы находятся в другой границе доверия — одних источников недостаточно для изоляции.
  • Авторизационные тесты покрывают конкретные пути доступа, но не гарантируют универсальную защиту от утечек. Перед настройкой общего доступа рекомендуется изучить документацию по границам безопасности.
  • Для синтеза ответов (gbrain think) требуется настроенная модель. Ключевой поиск работает без неё.

Для кого

GBrain полезен разработчикам и командам, которые уже пользуются AI-агентами и хотят сохранять контекст между сессиями, готовиться к встречам на основе накопленных фактов или вести общую базу знаний с контролем доступа. Проект используется автором в продакшене с объёмом более 150 тысяч страниц и подходит как для персональной, так и для корпоративной эксплуатации.