brainiphy
instalar

Documentación · Conceptos

De qué está hecho un cerebro.

Las palabras que usa la herramienta y qué significa cada una, los siete pasos que ejecuta de verdad una sincronización, y qué aspecto tiene todo eso como ficheros corrientes en tu propio disco.

Léelo una vez y la referencia de comandos deja de ser una lista. Si prefieres verlo funcionando primero, la guía rápida construye un cerebro en unos diez minutos.

Vocabulario

Siete palabras hacen casi todo el trabajo en esta documentación, y en la propia salida del CLI. Se usan de forma consistente y significan exactamente esto.

brain (cerebro)
La base de conocimiento de un negocio o de un cliente. Una carpeta corriente que puedes copiar, respaldar o borrar. No hay cuenta ni servidor detrás.
source (fuente)
Un sistema que alimenta un cerebro: una carpeta en este Mac, una subcuenta de un CRM, una API REST, una página pública.
connector (conector)
El script que trae una fuente y la escribe como Markdown normalizado. Uno por fuente, en connectors/<nombre>/sync.py dentro de tu propio proyecto.
preset
Un conector que brainiphy ya trae terminado para un sistema conocido. Tú das un identificador de cuenta y una credencial; no hay código que escribir.
graph (grafo)
Lo que graphify construye a partir de los ficheros normalizados: las personas, las empresas, las oportunidades y los documentos, y las aristas entre ellos. Vive en graphify-out/graph.json.
sync (sincronización)
Una ejecución de los conectores a los que les ha vencido el intervalo, más una reconstrucción del grafo si alguno llegó a ejecutarse.
step (paso)
Uno de los siete puntos de la lista de configuración de un cerebro.
skill
La skill de Claude Code que brainiphy instala, y que permite a Claude ejecutar por ti ese mismo recorrido de siete pasos.

Los siete pasos

Una lista de comprobación, no un asistente. brain vuelve a leer la carpeta cada vez que dibuja, así que siempre sabe qué pasos están hechos y te deja en el que estás de verdad. Puedes saltar de uno a otro.

La lista de cerebros en un terminal: cada cerebro con su progreso de configuración, número de fuentes, tamaño del grafo y hora de la última sincronización.
Todos los cerebros de esta máquina, por dónde va cada uno, cuánto hay dentro y cuándo se actualizó por última vez. Nada de esa pantalla está cacheado — cada línea se lee del cerebro en el momento de dibujarla, así que no puede decirte que un cerebro está al día cuando no lo está.
La lista de siete pasos en un terminal, con los pasos completados marcados y el cursor sobre el siguiente.
Pulsa ↵ para ejecutar el paso en el que estás. También puedes saltar: un cerebro nuevo pide la secuencia entera, pero uno que montaste hace seis meses solo necesita «añadir una fuente más», y hacerte pasar por los siete para llegar ahí sería absurdo.
  1. 1

    Instalar graphify

    El motor que convierte los ficheros recogidos en un grafo. El instalador lo hace por ti.

  2. 2

    Preparar el proyecto

    Crea registry.yaml, .gitignore y .graphifyignore, para que los scripts de los conectores no se indexen nunca como si fueran contenido.

  3. 3

    Añadir fuentes de datos

    Un conector por cada sistema que alimenta el cerebro: una carpeta, una URL, un CRM, una API.

  4. 4

    Terminar los conectores propios

    Escribe la descarga de todo lo que se generó como plantilla, y rellena los datos de cuenta que necesite un preset.

  5. 5

    Lanzar la primera sincronización

    Trae todas las fuentes e indéxalas en un grafo.

  6. 6

    Conectarlo a Claude

    Para que Claude Code, y si quieres Claude Desktop, puedan consultar el grafo.

  7. 7

    Mantenerlo sincronizado

    Un LaunchAgent que vuelve a ejecutar brain sync por su cuenta, haya o no un terminal abierto.

brain guide imprime esos mismos siete pasos como texto, deduce cuáles están hechos, y da el comando exacto para el siguiente — mira el paso 4 de la guía rápida.

Un cerebro en disco

Un cerebro es una carpeta corriente. Esto es todo lo que brain mete dentro — no hay nada escondido en ningún otro sitio del sistema salvo las credenciales, que están en el Llavero.

~/clients/acme
connectors/
├── registry.yaml         # qué conectores existen + su tipo e intervalo
├── <nombre>/sync.py      # un script por fuente de datos
├── state/<nombre>.json   # marcas de última ejecución, guían los intervalos
└── logs/                 # stdout/stderr del LaunchAgent
raw/<nombre>/             # salida del conector — Markdown normalizado
graphify-out/graph.json   # el grafo construido
.graphifyignore           # excluye connectors/ del indexado
.gitignore

registry.yaml está pensado para leerse y se puede editar a mano sin miedo — una entrada mal formada se salta, en vez de tumbar la sincronización entera. Todo lo que hay bajo state/, logs/, raw/ y graphify-out/ es generado y está en el gitignore.