01 Qué es GBrain y qué problema resuelve
Claude Code empieza cada sesión sin recordar lo que hablasteis ayer. CLAUDE.md ayuda con las reglas del proyecto, pero no está pensado para guardar cientos de clientes, reuniones o decisiones. GBrain es una capa de memoria open source (licencia MIT) que creó Garry Tan, presidente de Y Combinator, para sus propios agentes: indexa tus notas, guarda hechos con su origen y se los ofrece a Claude como herramienta MCP.
La diferencia con una carpeta de Obsidian o Notion es que no solo almacena: busca de forma híbrida (palabra exacta y significado), mantiene un grafo de relaciones entre personas, empresas y proyectos y, si configuras un modelo de chat, redacta respuestas con citas y te avisa de lo que no sabe o de lo que se ha quedado desactualizado.
Memoria con fuente
Cada hecho guardado conserva de dónde salió, y puedes corregirlo o retirarlo después.
Búsqueda híbrida
Combina búsqueda por palabras clave y vectorial. Puedes empezar sin claves de API solo con palabras clave.
Grafo de entidades
Enlaza páginas de personas, empresas y proyectos para responder preguntas como «quién trabaja en tal cliente».
Mantenimiento nocturno
El ciclo «dream» deduplica, arregla citas, puntúa relevancia y detecta contradicciones mientras no trabajas.
02 Antes de empezar: requisitos y costes
- ✓Bun 1.4.0 o superior (el motor de JavaScript con el que se ejecuta GBrain).
- ✓Claude Code instalado y funcionando en tu ordenador.
- ✓Tus notas en markdown o texto: una bóveda de Obsidian, una exportación de Notion o una carpeta de documentos.
- ✓Opcional: una clave de un proveedor de embeddings (Voyage es el predeterminado; también admite OpenAI, Gemini u Ollama en local) para la búsqueda por significado.
- ✓Opcional: una clave de un modelo de chat si quieres respuestas redactadas con citas mediante gbrain think.
El software es gratuito. Lo que puede costar dinero son las llamadas a proveedores externos: embeddings, reordenación de resultados y síntesis. Por eso el instalador te obliga a elegir un modo de búsqueda (conservative, balanced o tokenmax), que fija cuánto contexto se envía en cada consulta. Si vas justo de presupuesto, empieza sin claves y en modo conservador.
03 Instalación paso a paso
-
1
Instala Bun si no lo tienes
Compruébalo con bun --version. Si no aparece, usa el instalador oficial de bun.sh que verás en el bloque de comandos.
-
2
Instala GBrain desde GitHub
El comando descarga el repositorio oficial y deja el ejecutable gbrain disponible en todo el sistema.
-
3
Conéctalo a Claude Code
gbrain setup claude-code crea un cerebro local con PGLite si no existe, registra el servidor MCP y prueba la conexión. Con --dry-run ves antes lo que va a cambiar y con --remove lo deshaces.
-
4
Revisa la salud
gbrain doctor comprueba instalación, base de datos y claves. Es lo primero que debes ejecutar si algo falla.
-
5
Importa tus notas
Apunta gbrain import a tu carpeta. Con --no-embed indexas sin gastar en embeddings; podrás generarlos más tarde.
-
6
Prueba una búsqueda
Lanza una búsqueda desde la terminal y, después, abre Claude Code y pregúntale algo que solo esté en tus notas.
# 1. Bun (solo si no lo tienes)
curl -fsSL https://bun.sh/install | bash
# 2. GBrain desde el repositorio oficial
bun install -g github:garrytan/gbrain
# 3. Conexión con Claude Code (previsualiza primero)
gbrain setup claude-code --dry-run
gbrain setup claude-code
# 4. Diagnóstico
gbrain doctor
# 5. Importar notas sin generar embeddings todavía
gbrain import ~/notas/ --no-embed
# 6. Búsqueda de prueba
gbrain search "una frase que esté en tus notas" --json04 Que Claude Code lo instale por ti
El repositorio incluye un documento de instrucciones pensado para agentes, INSTALL_FOR_AGENTS.md. Si no te sientes cómodo en la terminal, pídele a Claude Code que lo siga y que se detenga en las decisiones que cuestan dinero.
Quiero añadir GBrain como memoria a Claude Code en este ordenador. Lee y sigue las instrucciones oficiales para agentes del repositorio garrytan/gbrain (archivo INSTALL_FOR_AGENTS.md en la rama master).
Condiciones:
- Empieza sin claves de API (modo keyless) y no actives captura automática, enriquecimiento de pago ni el ciclo nocturno sin preguntarme.
- Antes de cada comando, explícame en una frase qué hace.
- Cuando haya que elegir modo de búsqueda, enséñame las opciones con su coste aproximado y espera mi respuesta.
- No toques configuración que no tenga que ver con GBrain.
- Mi carpeta de notas está en: [RUTA DE TU CARPETA].
Al terminar, ejecuta gbrain doctor, resume qué quedó instalado y dónde se guardan mis datos, y dime cómo comprobar en una sesión nueva que realmente estás consultando GBrain.05 Cómo usarlo en el día a día
Una vez conectado, no necesitas escribir comandos: basta con pedirle a Claude cosas como «¿qué sé de este cliente antes de la reunión?» o «recuerda esto con su fuente». Para comprobar a mano tienes dos órdenes: gbrain search devuelve las páginas más relevantes y gbrain think redacta una respuesta con citas y una nota de lo que falta (necesita un modelo de chat configurado).
Consulta mi memoria de GBrain antes de responder. Mañana me reúno con [NOMBRE DE LA PERSONA] de [EMPRESA].
1. Resume quién es, qué relación tenemos y cuándo hablamos por última vez.
2. Lista los temas pendientes entre nosotros, con la página de origen de cada dato.
3. Señala qué información puede estar desactualizada o qué no aparece en la memoria.
4. Propón tres preguntas para la reunión.
No completes huecos con suposiciones: si algo no está en GBrain, dilo.| Orden | Para qué sirve |
|---|---|
| gbrain search | Recuperar páginas relevantes sin generar respuesta |
| gbrain think | Respuesta redactada con citas y análisis de lagunas |
| gbrain dream | Ejecutar a mano el mantenimiento nocturno |
| gbrain autopilot --install | Programar el mantenimiento automático |
| gbrain integrations list | Ver recetas de conexión con correo, calendario o voz |
06 Privacidad, límites y buenas prácticas
Con PGLite la base de datos vive en tu ordenador y sirve para cerebros personales de hasta unas 50.000 páginas; para equipos o volúmenes mayores el proyecto recomienda Postgres con pgvector. Ten en cuenta que, aunque la base sea local, el texto sí sale de tu equipo si configuras embeddings, reordenación o síntesis en la nube, y que Claude ve lo que recupera de la memoria.
- ✓No importes contratos, datos de salud ni información de clientes sin revisar qué proveedores reciben el texto.
- ✓Haz copias de la base de datos: la exportación a markdown no es una copia completa.
- ✓Activa el ciclo nocturno solo cuando hayas visto qué hace con gbrain dream en manual.
- ✓Si compartes el cerebro con tu equipo, lee antes la documentación de permisos del repositorio.
- ✓Ejecuta gbrain doctor tras cada actualización.
Preguntas frecuentes
No. CLAUDE.md sigue siendo el sitio para las reglas del proyecto. GBrain guarda conocimiento: personas, empresas, decisiones y notas que crecen con el tiempo.
Sí. En modo keyless funciona con búsqueda por palabras clave. Los embeddings, la reordenación y la síntesis con citas requieren proveedores que pueden cobrar.
No hace falta. Puedes seguir escribiendo en Obsidian e importar la bóveda; GBrain indexa los archivos y añade búsqueda, grafo y memoria para Claude.
Sí. El repositorio documenta conexiones para Codex, Cursor, Windsurf y otros clientes MCP, además de un modo servidor HTTP para usar el mismo cerebro desde varias máquinas.
Ejecuta gbrain doctor. Si el problema es de la base de datos, el proyecto recomienda gbrain engine status --probe y gbrain db-repair antes de cambiar la configuración.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.