Repolode
Enviar
garrytan

garrytan/gbrain

Uma camada de memória self-hosted para agentes de IA, que armazena fatos explícitos com fontes e compartilha um cérebro entre agentes, clientes MCP e a CLI.

Ver no GitHub
Estrelas
31,577
Forks
4,705
Issues abertas
566
Último commit
há 20 horas

O que é?

O GBrain oferece memória persistente para um agente de IA, sob seu controle. Ele armazena fatos em páginas Markdown com suas fontes, permite corrigir e retirar fatos e disponibiliza o mesmo cérebro para vários agentes via MCP ou CLI. Uma configuração sem chaves, com recuperação por palavras-chave, funciona localmente no PGLite; busca semântica, síntese e enriquecimento em segundo plano são opcionais e exigem provedores de embeddings ou modelos configurados.

Além da recuperação, o GBrain pode criar um grafo de conhecimento tipado a partir de gravações confiáveis de páginas locais, permitindo fazer perguntas sobre relações, como quem trabalha em determinada empresa. A camada opcional de síntese fornece respostas com citações e aponta lacunas no que o cérebro sabe. Tarefas agendadas podem importar, deduplicar e consolidar páginas enquanto você estiver ausente.

O projeto é voltado a desenvolvedores que usam agentes de programação como Claude Code, Codex ou Cursor, ou agentes pessoais sempre ativos, como OpenClaw e Hermes. Ele oferece um banco de dados PGLite local para uso pessoal e Postgres com pgvector para implantações compartilhadas ou maiores, além de um servidor MCP remoto com OAuth e acesso com escopo.

Recursos principais

  • 01Armazena fatos explícitos com fontes e permite corrigi-los ou retirá-los.
  • 02Funciona sem chaves com PGLite local e recuperação por palavras-chave; a busca semântica é opcional.
  • 03Disponibiliza um mesmo cérebro para vários agentes via MCP por stdio ou HTTP e pela CLI.
  • 04Cria um grafo de conhecimento tipado a partir de gravações confiáveis de páginas locais para consultas sobre relações.
  • 05Oferece um comando opcional de síntese que retorna respostas com citações e aponta lacunas de conhecimento.
  • 06Oferece suporte a Postgres com pgvector para implantações compartilhadas ou maiores.

Casos de uso

  • Dar memória persistente entre sessões a um agente de programação como Claude Code ou Codex.
  • Compartilhar uma base de conhecimento pesquisável entre vários clientes de IA de uma equipe.
  • Executar um agente pessoal sempre ativo que mantenha notas, contatos e histórico de reuniões.
  • Consultar relações entre pessoas, empresas e negócios registrados em notas Markdown.

Início rápido

  1. 1

    Instale o GBrain com Bun (requer Bun 1.4.0 ou superior; não está no npm)

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

    Configure o GBrain para o Claude Code (ou execute com codex)

    gbrain setup claude-code

Antes de usar

  • Requer Bun 1.4.0 ou superior.
  • Não é distribuído pelo npm, e o pacote npm chamado gbrain não tem relação com ele e pode ocultar o binário verdadeiro.
  • A operação contínua exige um servidor implantado com pelo menos 8 GB de RAM, além de custos recorrentes com tokens de API.
  • A busca semântica, a síntese e o enriquecimento exigem provedores de nuvem ou chaves de API de modelos configuradas separadamente.

Em coleções

Memória de longo prazo para agentes de IAFrameworks e apps de agentes de IA open sourceServidores MCP

Tópicos

#ai-agent#memory#mcp#knowledge-graph#typescript#bun#postgres#vector-search

Perguntas frequentes

O que é gbrain?
Uma camada de memória self-hosted para agentes de IA, que armazena fatos explícitos com fontes e compartilha um cérebro entre agentes, clientes MCP e a CLI. O GBrain oferece memória persistente para um agente de IA, sob seu controle. Ele armazena fatos em páginas Markdown com suas fontes, permite corrigir e retirar fatos e disponibiliza o mesmo cérebro para vários agentes via MCP ou CLI. Uma configuração sem chaves, com recuperação por palavras-chave, funciona localmente no PGLite; busca semântica, síntese e enriquecimento em segundo plano são opcionais e exigem provedores de embeddings ou modelos configurados.
gbrain é gratuito? Qual é a licença?
gbrain é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
gbrain ainda é mantido?
Manutenção ativa. O último commit de gbrain foi em 6 de nov. de 2026.
Para que posso usar gbrain?
Dar memória persistente entre sessões a um agente de programação como Claude Code ou Codex. Compartilhar uma base de conhecimento pesquisável entre vários clientes de IA de uma equipe. Executar um agente pessoal sempre ativo que mantenha notas, contatos e histórico de reuniões. Consultar relações entre pessoas, empresas e negócios registrados em notas Markdown.
Como instalar gbrain?
Instale o GBrain com Bun (requer Bun 1.4.0 ou superior; não está no npm): bun install -g github:garrytan/gbrain Configure o GBrain para o Claude Code (ou execute com codex): gbrain setup claude-code
Onde consigo gbrain?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/garrytan/gbrain

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados