Sobre el proyecto

GBrain es un sistema de memoria para agentes de IA, creado por Garry Tan y utilizado en sus propios despliegues de OpenClaw y Hermes. Almacena hechos explícitos junto con sus fuentes, admite correcciones y retirada de recuerdos, y pone la misma memoria a disposición de múltiples agentes. El proyecto enfatiza que el usuario es dueño del cerebro: se ejecuta en tu hardware, tu base de datos y tus claves. Capacidades principales descritas en el README: - Inicio sin claves: la recuperación por palabras clave y la memoria escrita por agentes funcionan sin claves API. Las claves opcionales mejoran a búsqueda semántica (OpenAI o Voyage) y extracción automática de hechos (OpenAI o Anthropic). - Capa de síntesis: devuelve respuestas en prosa citadas sobre personas, empresas, acuerdos e ideas, además de una nota explícita sobre lo que el cerebro aún no sabe (análisis de brechas), en lugar de una lista de fragmentos coincidentes. - Grafo de conocimiento auto-conectable: cada escritura de página extrae referencias a entidades y crea aristas tipadas como attended, works_at, invested_in, founded y advises, sin llamadas a LLM. El README reporta cifras de referencia (P@5 49.1%, R@5 97.9% en un corpus de 240 páginas) y dice que las tarjetas de puntuación viven en un repositorio hermano gbrain-evals. - Cerebro empresarial multiinquilino: cada miembro del equipo obtiene una porción delimitada del cerebro según su inicio de sesión, de modo que las consultas solo devuelven lo que el usuario tiene permitido ver. El README afirma que las pruebas fuzz en búsqueda, listado, consulta y lecturas de múltiples fuentes no produjeron fugas. - Demonio en segundo plano: ingesta 24/7, enriquecimiento y un ciclo de consolidación nocturno, descrito como la ejecución autónoma de 66 trabajos cron en el despliegue del autor. Instalación e integración: - Requiere Bun 1.3.11 o superior. El README advierte que GBrain no se distribuye en npm y que existe un paquete npm no relacionado llamado gbrain; instala mediante `bun install -g github:garrytan/gbrain` o clonando y ejecutando `bun install && bun link`. - Múltiples rutas de configuración: añadir memoria a un agente existente (Grok Bot, Muse, Codex, Claude Code), conectar un cerebro alojado existente, o un despliegue completo alojado en servidor en OpenClaw o Hermes con plantillas de un clic. - Se puede crear un cerebro local en unos dos segundos con `gbrain init --pglite` (sin Docker, sin servidor) y luego conectarlo a Claude Code o Codex mediante MCP. Un modo `--surface verbs` expone siete verbos de memoria: recall, remember, entity, synthesize, forget, context_pack y delta. - Los cerebros remotos se pueden conectar con `gbrain connect <url> --token ...`, y `gbrain agent register` acuña clientes OAuth y tokens con ámbito limitado para incorporar arneses de agentes. - Existen guías de integración MCP para Claude Code, Codex, Cursor/Windsurf, Hermes, Grok Bot, Grok Build, opencode, OpenClaw, Claude Desktop/Cowork y Perplexity Computer. - El arranque opcional de agente personal convierte a Codex o Claude Code en un agente persistente con archivos de identidad (SOUL.md, USER.md, MEMORY.md), un repositorio privado de GitHub y un cerebro PGLite local. Una habilidad `cold-start` importa Gmail, calendario y contactos mediante un conector nativo, ClawVisor o archivos sin conexión como Google Takeout. Notas operativas: el README afirma que un clon de Git por sí solo no es una copia de seguridad completa porque la base de datos también contiene hechos, correcciones, trabajos y contabilidad, y remite a una guía completa de copia de seguridad y restauración. También señala que los recuerdos guardados por agentes son visibles en todo el cerebro por defecto a menos que se marquen como privados, y que actualizar un cerebro existente puede requerir reconstruir los fragmentos de búsqueda.