Construye un cerebro, y mantenlo cierto.

Qué es brainiphy#

Todo lo que sabe un negocio está repartido entre sistemas que no se hablan entre sí: propuestas en una carpeta de Drive, contactos y oportunidades en un CRM, los números del año pasado en una hoja de cálculo, notas de reuniones en los Documentos de alguien. Pregúntale a Claude por cualquiera de esas cosas y no tiene ni idea. La información existe — simplemente no está en ningún sitio al que Claude pueda llegar.

brainiphy construye ese sitio alcanzable, uno por cliente. Lo apuntas a tus carpetas y tus sistemas; él lo trae todo, lo indexa en un grafo de conocimiento, y enchufa ese grafo a Claude. Y después se mantiene al día en segundo plano.

Cuatro etapas, de izquierda a derecha#

La diferencia que marca la tercera etapa es la que hay entre una carpeta llena de ficheros y algo capaz de responder a a qué clientes presupuestamos en marzo y nunca nos volvieron a decir nada.

Qué vas a necesitar#

• Un Mac. La programación usa el launchd del propio macOS, y las credenciales viven en el Llavero de macOS. Esas son las dos razones por las que no hay versión para Linux ni Windows.
• Python 3.9 o superior — ya presente en casi todos los Mac.
• Nada más. El instalador trae graphify y las dos librerías de Python que necesita.

Hace falta un modelo para indexar documentos, pero no necesariamente una clave de API — mira indexado, modelos y coste.

Instalación#

Un solo comando. Lo monta todo en su propia carpeta aislada, así que no puede molestar a nada más de tu Mac, e informa al final de si encontró lo que necesita.

$ curl -fsSL https://raw.githubusercontent.com/rvst312/brainiphy/main/install.sh | bash

Y después:

$ brain

Mira antes de saltar#

Razonable, para cualquier cosa que se redirija a bash. Descárgalo y haz que te cuente lo que haría:

$ curl -fsSL https://raw.githubusercontent.com/rvst312/brainiphy/main/install.sh -o install.sh
$ bash install.sh --dry-run

Fuera de su propia carpeta, el instalador toca exactamente tres cosas: dos accesos en ~/.local/bin, un bloque marcado en el perfil de tu shell (del que hace copia antes), y un enlace que lo registra en Claude Code.

Opciones del instalador#

Instalar desde un clon, para trabajar sobre brainiphy o sobre un fork:

$ git clone https://github.com/rvst312/brainiphy.git
$ bash brainiphy/install.sh --prefix "$PWD/brainiphy"

Desinstalar#

$ bash install.sh --uninstall

Elimina el virtualenv, los dos accesos, el bloque marcado del perfil de tu shell y el enlace de la skill. Tus cerebros son carpetas tuyas y se quedan como están.

Guía rápida#

Un cerebro completo para un cliente, de una carpeta vacía a un grafo que Claude puede consultar. Esto recorre los siete pasos a mano para que veas qué hace cada uno; en la práctica brain a secas ejecuta esa misma secuencia y te dice en qué paso estás.

1. Crear el cerebro#

brain init prepara una carpeta corriente para recibir conectores. Se puede repetir sin miedo: nunca sobrescribe un registro existente.

$ mkdir -p ~/clients/acme
$ brain init ~/clients/acme

Eso escribe connectors/registry.yaml y connectors/state/, añade los directorios de salida generada a .gitignore, y añade connectors/ a .graphifyignore para que tus scripts de conector no se indexen nunca como si fueran contenido.

2. Añadir una fuente que ya tienes#

La fuente más barata es una carpeta de este Mac — incluida una carpeta sincronizada de Drive o Dropbox. Se genera completa y funciona en la siguiente sincronización.

$ brain new-connector ~/clients/acme docs --mirror ~/Dropbox/acme

3. Añadir una fuente que necesita credencial#

Para un sistema con preset, tú pones un identificador de cuenta y un token — sin código. Ejecuta brain presets para ver qué viene hoy y qué necesita cada uno.

$ brain new-connector ~/clients/acme crm --preset gohighlevel --var LOCATION_ID=abc123
$ brain secret set graphify-acme-crm

La petición del secreto va oculta mientras escribes. La credencial va al Llavero de macOS y a ningún otro sitio — nunca a registry.yaml, nunca a un argumento de comando.

4. Comprobar por dónde vas#

brain guide lee el proyecto y deduce qué pasos están hechos, qué les falta a los pendientes, y el comando exacto que toca. Solo lee, así que se puede ejecutar en cualquier sitio.

brain guide ~/clients/acme

4/7 done   ✓ done  ▸ next  ○ pending  – n/a

 ✓ 1  Install graphify
 ✓ 2  Scaffold the project
 ✓ 3  Add data sources
 ▸ 4  Finish the custom connectors
 not runnable yet: hubspot (needs code)
 write the fetching for anything generated from a stub, and fill in the
 account details a preset needs
 $EDITOR ~/clients/acme/connectors/hubspot/sync.py
 ✓ 5  Run the first sync
 ○ 6  Connect it to Claude
 not connected yet
 brain connect-claude ~/clients/acme --desktop --trust-desktop
 ○ 7  Keep it in sync
 not scheduled — sync is manual for now
 brain schedule ~/clients/acme --interval-minutes 15 --load

↳ next step:
    $EDITOR ~/clients/acme/connectors/hubspot/sync.py

Los pasos se pueden hacer en desorden, y por eso el 5 está marcado mientras el 4 no lo está. Un cerebro que montaste hace seis meses normalmente solo necesita «añadir una fuente más», y hacerte pasar por los siete para llegar ahí sería absurdo.

5. Primera sincronización#

Esto trae todas las fuentes y las indexa. La primera construcción es siempre completa, y es la lenta — las sincronizaciones posteriores solo ejecutan lo que toca.

$ brain sync ~/clients/acme

Imprime ran=[...] skipped=[...] errors=[...] graph_rebuilt=<bool> y sale con código distinto de cero si algún conector falló, así que encaja directamente en un script o en un job de CI.

6. Enchufarlo a Claude#

$ brain connect-claude ~/clients/acme

Eso conecta Claude Code. Añade --desktop para registrar además el grafo en Claude Desktop, y reinicia Desktop después para que lo tome.

7. Dejar de pensar en ello#

$ brain schedule ~/clients/acme --interval-minutes 15 --load

Ahora macOS vuelve a ejecutar la sincronización por su cuenta, haya o no un terminal abierto. Los logs caen en connectors/logs/.