Para agencias, consultores y equipos de operaciones
Todo lo que sabes de un cliente, en un sitio desde el que Claude puede responder.
brainiphy recoge las carpetas, los registros del CRM, el correo y los documentos de un negocio en un único grafo de conocimiento, enchufa ese grafo a Claude y lo vuelve a sincronizar con una frecuencia fija. Dejas de reexplicar la cuenta cada semana — y las respuestas siguen cuadrando con lo que es cierto de verdad.
- 01Una tarde para montar una cuenta. Después se mantiene sola.
- 02El grafo, los ficheros y las credenciales se quedan en tu Mac. Nada alojado, ninguna cuenta que crear.
- 03Funciona con la suscripción de Claude que ya pagas — o con tu propia clave, o con un modelo local.
$ curl -fsSL https://raw.githubusercontent.com/rvst312/brainiphy/main/install.sh | bashdespués: brain new ~/clients/acme
Lee el código — MIT, gratis, sin cuenta.
Solo macOS. Python 3.9 o superior. Es una herramienta de línea de comandos — no hay interfaz gráfica ni versión alojada.
¿No eres quien maneja el terminal? Lo construimos para tu empresa y lo mantenemos sincronizado.
? en qué punto está la renovación de Acme
Ganada el 12 de agosto — 48.000 $ a 12 meses. Sarah (CFO) dio el visto bueno tras la Propuesta v3; la factura 1180 salió dos días después.
Lámina I — el grafo de un cliente: los registros, las personas y cómo se conectan.
Lámina II — a dos fuentes les tocaba, a una no. Un conector traía cambios, así que el grafo se reconstruyó una vez.
La respuesta cara es la que lleva seis semanas obsoleta sin avisar
Construir el cerebro es la parte fácil. En una tarde tienes la carpeta de notas, el Drive y el CRM indexados, conectados y respondiendo bien. Es una buena tarde.
Después cae una propuesta en Drive. Una oportunidad pasa a Ganada. Alguien renombra el proyecto a media faena. Nada de eso falla con estruendo — no hay error ni alerta, porque no se ha roto nada.
El cerebro simplemente empieza a responder desde el mes pasado, con exactamente el mismo tono seguro que usaba cuando acertaba.
Eso es lo que mata estos montajes, y cuesta más que una respuesta mala. Lo compruebas dos veces, está bien, dejas de comprobarlo — y entonces das una cifra obsoleta en una llamada con el cliente y te pasas la semana siguiente reconstruyendo la confianza que tardaste un año en ganar.
Mantenerlo al día es el problema para el que sirve brainiphy de verdad. Meter los datos es fontanería, y esa parte ya está escrita.
El ciclo, completo
- 01Cada fuente tiene su conector — un script pequeño que trae registros y los escribe en un único formato normalizado.
- 02Cada fuente declara cada cuánto hay que revisarla. Un CRM cada hora, una carpeta de archivo una vez al día.
- 03
brain syncejecuta solo lo que toca, y reconstruye el grafo solo si algo llegó a ejecutarse. Los días tranquilos no cuestan nada. - 04
brain schedulele entrega ese ciclo a macOS mediante launchd, para que dejes de ser tú el programador de tareas.
Dónde aparece esto durante la semana
Un grafo de conocimiento es una abstracción. Estos son los cuatro momentos en los que se gana la tarde que costó, o no.
En una llamada
El cliente pregunta en qué punto está algo
Se lo preguntas al cerebro y respondes en la misma llamada, con la cifra y la fecha, en vez de prometer que lo miras y contestar el jueves.
Primera semana
Entra alguien nuevo en la cuenta
Le pregunta al cerebro lo que si no te habría preguntado a ti. La incorporación deja de ser un impuesto sobre tu calendario.
A escala
Llevas ocho cuentas, no una
Cada cliente es su propia carpeta y su propia frecuencia. La octava cuesta lo mismo de mantener al día que la primera, porque no la mantiene nadie a mano.
Época de renovaciones
Necesitas todo el histórico, hoy
Las propuestas, las llamadas, las facturas y cómo se conectan ya están montadas. Preparar la reunión es leer, no hacer arqueología.
Nada de eso es una capacidad nueva — siempre pudiste sacar la respuesta del Drive y del CRM tú mismo. Lo que cambia es el precio de hacerlo: de veinte minutos y un cambio de contexto, a una pregunta.
Las cuatro cosas que estás a punto de preguntar
- «Lo ejecuto otra vez el mes que viene. ¿Acabo con dos de todo?»
- No — y esta es la pregunta que decide si esto seguirá valiendo algo dentro de tres meses. Cada registro se identifica por su ID en el sistema de origen, así que la segunda pasada sobrescribe la primera en el sitio. Una oportunidad que pasó de Propuesta a Ganada es el mismo nodo con un valor nuevo, no un segundo nodo que contradice al primero.
- «¿Dónde acaba el token de la API de mi cliente?»
- En el Llavero de macOS, referenciado por su nombre. Nunca escrito en un fichero de configuración, nunca pasado por línea de comandos donde acabaría en el historial de tu shell, nunca pegado en una conversación con un modelo. Esa es también la razón honesta de que la herramienta sea solo para macOS: el Llavero y launchd son la base sobre la que está construida.
- «¿Qué añade esto a lo que ya pago?»
- La herramienta es gratis y con licencia MIT — sin cuenta, sin usuarios, sin plan alojado. Indexar documentos necesita un modelo, y si tienes Claude Code instalado funciona con la suscripción Pro o Max que ya pagas. Puedes apuntarlo a tu propia clave de API o a un modelo local; esa elección es la que importa para la cuestión de privacidad de más abajo.
- «Mi cliente usa algo de lo que no ha oído hablar nadie.»
- Entonces alguien escribe un conector: un script, una función, que devuelve una lista de registros. Sin registro de plugins, sin clase base, sin lista de espera de ningún proveedor. Una fuente nueva es una tarde de trabajo — que es justo lo que hace que valga la pena conectar sistemas internos raros.
Lámina III — cambiaron cuatro registros en origen · cuatro nodos actualizados · nada duplicado
Dónde vive de verdad la verdad de un cliente
Lo más barato primero. La mayor parte de una cuenta real cae en las dos primeras filas — una carpeta compartida y un CRM — y solo pagas ingeniería por los sistemas que nadie ha visto nunca.
- una carpeta en este Mac
- replicada — no hay conector que escribir
- un sistema con preset
- generado por ti, solo pones la credencial
- cualquier API REST
- un conector: una petición, un mapeo
- una URL pública
- se añade directamente, nada que autenticar
- cualquier otra cosa
- un script propio que devuelve registros
SOURCE_SYSTEM = "hubspot"
def fetch_records() -> list[dict]:
token = get_secret("graphify-acme-hubspot")
req = urllib.request.Request(
"https://api.example.com/v3/records",
headers={"Authorization": f"Bearer {token}"},
)
with urllib.request.urlopen(req, timeout=30) as resp:
data = json.load(resp)
return [
{"id": r["id"], "title": r["name"], "body": r["notes"]}
for r in data["results"]
]Ese es el contrato entero, para la única persona del equipo que lo va a leer. Cada registro necesita un id, un title y un body; cualquier otra clave que devuelvas pasa a ser consultable. El id es lo que impide que la pasada del mes que viene duplique la de este.
Escribir un conector cubre el resto: los cuatro tipos de fuente, y qué enfoque sale más barato para un sistema que nadie ha visto nunca.
Una tarde por cliente, repartida en una semana
$ brain new ~/clients/acmeUn solo comando recorre toda la configuración, dice para qué sirve cada paso y genera todo lo que puede generar. Apúntalo a una carpeta de tu Mac y ese conector queda escrito, dado de alta y funcionando antes de que te haga la siguiente pregunta.
Cada paso es opcional y se puede repetir, y eso importa más de lo que parece — vas a empezar una cuenta, te van a liar con otra cosa, y vas a volver el jueves. brain guide te dice dónde lo dejaste y qué ejecutar ahora.
Además viene como skill de Claude Code, así que puedes darle el manual al agente en vez de conducirlo tú. La guía rápida recorre esos mismos siete pasos por escrito.
- 01install graphify — done
- 02scaffold the project — done
- 03add data sources — done
- 04implement the custom connectors — done
- 05run the first sync — next
- 06connect it to Claude — pending
- 07keep it in sync — pending
Comandos
Toda la superficie, para quien de tu equipo lo vaya a ejecutar de verdad. Son nueve, y pasada la primera semana usas tres.
- brain new <ruta>
- Recorre toda la configuración y genera todo lo que puede.
- brain sync
- Ejecuta los conectores que tocan. Reconstruye solo si algo se ejecutó.
- brain schedule
- Entrega el bucle de sincronización a launchd, o mira qué hay programado.
- brain status
- Conectores, últimas sincronizaciones, número de nodos.
- brain guide
- Por dónde va este cerebro, y el comando exacto que toca ahora.
- brain new-connector <nombre>
- Escribe la plantilla de un conector, ya dada de alta.
- brain connect-claude
- Registra el grafo en Claude Code y Claude Desktop.
- brain secret set/get
- Guarda y lee una credencial en el Llavero de macOS.
- brain init
- Prepara la configuración en una carpeta que ya tienes.
Cada flag, y qué escribe cada comando en disco, está en la referencia de comandos. El README es la versión corta.
Lo que no va a hacer por ti
- Funcionar fuera de macOS
- Está construido sobre el Llavero y launchd. No hay versión para Linux ni Windows, y no va a haberla pronto — así que si la cuenta vive en un portátil con Windows, esta no es tu herramienta.
- Funcionar sin Python 3.9+
- Los conectores son Python. Si
python3 --versiondice 3.8, esto todavía no va a funcionar. - Darle al cliente una pantalla donde hacer clic
- Es un CLI, y es para quien lleva la cuenta, no para el cliente. La configuración es un fichero YAML, los conectores son scripts, y la salida es texto.
- Instalarse desde Homebrew
- Todavía no — hace falta una release etiquetada. Hoy la vía soportada es el instalador por curl.
Dónde acaban de verdad los datos de tu cliente
El CLI, el grafo y las credenciales se quedan en tu máquina. No hay cuenta de brainiphy, no hay servidor de brainiphy, y nada llama a casa — que es la respuesta corta al cuestionario de seguridad.
Pero indexar un documento significa enviar su contenido a un modelo de lenguaje. Eso es lo que convierte un PDF en algo desde lo que el grafo puede responder, y es el único punto en el que los datos salen de tu Mac. Dilo antes de apuntar esto a los ficheros de un cliente.
Tú eliges el modelo: tu suscripción de Claude a través de Claude Code, tu propia clave de API, o un modelo local. Si los documentos de un cliente no pueden ir a un proveedor alojado, ejecuta uno en local — no cambia nada más de la herramienta.
Las credenciales son la excepción sin asterisco. Viven en el Llavero y no se envían nunca a ningún sitio salvo a la API contra la que autentican.
Antes de instalar nada
Hay un grafo funcionando en esta web. Pregúntale algo.
Una empresa entera inventada — diez departamentos, 123 registros — con un chat que responde a partir de ellos y te enseña qué registros ha leído.
La demo está en inglés: los registros de la empresa de ejemplo lo están, y traducir el envoltorio dejando dentro los documentos en inglés no ayudaría a nadie.
Móntalo para un cliente. Mira si sigue acertando dentro de un mes.
Esa es la única prueba que importa, cuesta una tarde ponerla en marcha, y la herramienta es gratis en cualquier caso.
$ curl -fsSL https://raw.githubusercontent.com/rvst312/brainiphy/main/install.sh | basho lee el código primero — algo razonable de hacer con una herramienta a la que estás a punto de dar las credenciales de tu cliente.
Lo hacemos nosotros
¿No eres quien maneja el terminal?
Buscamos dónde viven tus respuestas, escribimos un conector por cada sistema, enchufamos el grafo a Claude, y lo reparamos cuando una API de origen cambia.
Ver el servicio