gbrain

GBrain est un système de mémoire pour agents IA, créé par Garry Tan et utilisé dans ses propres déploiements OpenClaw et Hermes. Il stocke des faits explicites avec leurs sources, prend en charge les corrections et le retrait de souvenirs, et rend la même mémoire disponible à plusieurs agents. Le projet souligne que l'utilisateur possède le cerveau : il fonctionne sur votre matériel, votre base de données et vos clés. Capacités principales décrites dans le README : - Démarrage sans clé : la recherche par mots-clés et la mémoire écrite par l'agent fonctionnent sans clé API. Des clés optionnelles permettent la recherche sémantique (OpenAI ou Voyage) et l'extraction automatique de faits (OpenAI ou Anthropic). - Couche de synthèse : renvoie des réponses en prose citées sur les personnes, entreprises, transactions et idées, ainsi qu'une note explicite sur ce que le cerveau ne sait pas encore (analyse des lacunes), plutôt qu'une liste de fragments correspondants. - Graphe de connaissances auto-câblé : chaque écriture de page extrait des références d'entités et crée des arêtes typées telles que attended, works_at, invested_in, founded et advises, sans appels LLM. Le README rapporte des chiffres de référence (P@5 49.1%, R@5 97.9% sur un corpus de 240 pages) et indique que les tableaux de bord se trouvent dans un dépôt voisin gbrain-evals. - Cerveau d'entreprise multi-locataire : chaque membre de l'équipe obtient une tranche limitée du cerveau via sa connexion, de sorte que les requêtes ne renvoient que ce que l'utilisateur est autorisé à voir. Le README indique que les tests de fuzz sur la recherche, la liste, la consultation et les lectures multi-sources n'ont produit aucune fuite. - Daemon en arrière-plan : ingestion 24h/24 et 7j/7, enrichissement et cycle de consolidation nocturne, décrit comme exécutant 66 tâches cron de manière autonome dans le déploiement de l'auteur. Installation et intégration : - Nécessite Bun 1.3.11 ou plus récent. Le README avertit que GBrain n'est pas distribué sur npm et qu'un paquet npm sans lien nommé gbrain existe ; installez via `bun install -g github:garrytan/gbrain` ou clonez puis `bun install && bun link`. - Plusieurs chemins de configuration : ajouter de la mémoire à un agent existant (Grok Bot, Muse, Codex, Claude Code), connecter un cerveau hébergé existant, ou un déploiement complet sur serveur avec OpenClaw ou Hermes via des modèles en un clic. - Un cerveau local peut être créé en environ deux secondes avec `gbrain init --pglite` (sans Docker, sans serveur), puis connecté à Claude Code ou Codex via MCP. Un mode `--surface verbs` expose sept verbes de mémoire : recall, remember, entity, synthesize, forget, context_pack et delta. - Les cerveaux distants peuvent être connectés avec `gbrain connect <url> --token ...`, et `gbrain agent register` génère des clients et jetons OAuth limités pour l'intégration de harnais d'agents. - Des guides d'intégration MCP existent pour Claude Code, Codex, Cursor/Windsurf, Hermes, Grok Bot, Grok Build, opencode, OpenClaw, Claude Desktop/Cowork et Perplexity Computer. - Un bootstrap optionnel d'agent personnel transforme Codex ou Claude Code en agent persistant avec des fichiers d'identité (SOUL.md, USER.md, MEMORY.md), un dépôt GitHub privé et un cerveau PGLite local. Une compétence `cold-start` importe Gmail, le calendrier et les contacts via un connecteur natif, ClawVisor, ou des archives hors ligne comme Google Takeout. Notes opérationnelles : le README indique qu'un simple clone Git ne constitue pas une sauvegarde complète car la base de données contient également des faits, des corrections, des tâches et de la comptabilité, et renvoie à un guide complet de sauvegarde et de restauration. Il note également que les souvenirs enregistrés par les agents sont visibles par tout le cerveau par défaut, sauf s'ils sont marqués privés, et que la mise à niveau d'un cerveau existant peut nécessiter de reconstruire les fragments de recherche.