Booboo

🐾 Booboo — el cerebro operativo unificado

Convierte los datos de cualquier sistema de IA en un cerebro 3D vivo y enraizado — estructura + conocimiento + memoria + agentes + automatizaciones fusionados en un único grafo. Consúltalo por REST o MCP, visualízalo en tu navegador o como fondo de escritorio, y arranca tus agentes desde él con una sola llamada.

Pruébalo antes de instalarlo → booboo.fractionalhq.uk · un cerebro en vivo en tu navegador, sin registro, sin nada que clonar.

Lleva el nombre de un perro salchicha que nunca olvida dónde están enterradas las golosinas. Apropiado, porque Booboo trata exactamente de eso: memoria y recuperación — ver todo el sistema de una vez, recuperar lo que está enterrado, nunca perder el hilo.

Sin retoques: booboo view --demo --nodes 50000 — 50k nodos, 4 capas, en vivo en una pestaña del navegador, cero errores de consola. Pruébalo tú mismo con un solo comando.

La mayoría de las herramientas muestran una porción: un grafo de conocimiento, un diagrama de flujo de agentes, un almacén de memoria, un visor de trazas. Booboo los fusiona todos en un único grafo enraizado en un solo punto, para que puedas ver — y consultar — cómo encaja realmente todo el sistema.

Estado: alfa — ocho paquetes publicados: @booboo-brain/spec (el contrato), @booboo-brain/build (adaptadores postgres/json basados en configuración), @booboo-brain/serve (capa de consulta REST + MCP), @booboo-brain/viewer (render 3D de un millón de nodos), @booboo-brain/panel (el organigrama), @booboo-brain/vault (exportación markdown con enlaces wiki), @booboo-brain/cli (el comando unificado booboo) y create-booboo (generador de proyectos). Semver por paquete — consulta cada package.json. MIT.

---

La idea central

Booboo es una especificación JSON diminuta en el centro, con adaptadores que la alimentan y consumidores que renderizan/sirven/consultan:

  your data ──▶  ADAPTERS  ──▶  GRAPH JSON ──▶  CONSUMERS
  (postgres,     (config-       (the spec,       (3D viewer ·
   json, neo4j,   driven,        ~1 KB            REST API ·
   mcp, …)        ~50 lines)     contract)        MCP server · wallpaper)

Emite el JSON → obtén el visor, la API y el servidor MCP gratis. Datos extraños → un adaptador de ~50 líneas, no un fork. Consulta SPEC.md.

Inicio rápido

Un solo comando. Sin base de datos, sin configuración, sin registro. Un cerebro sintético, ejecutándose en tu máquina:

npx @booboo-brain/cli view --demo --nodes 1000000

Ese es el gran titular: un millón de nodos a 60fps en una pestaña del navegador. Reduce el número a --nodes 50000 en un portátil modesto. Consulta SCALE.md para ver cómo aguanta (una sola llamada de dibujo sobre una nube de puntos con un shader personalizado, más LOD por niveles en las etiquetas).

Si aguanta en tu máquina, deja una estrella. No hay marketing detrás de este repositorio; las estrellas son cómo el próximo constructor lo encuentra.

Luego apúntalo a tu propio stack:

# scaffold a project (json starter + postgres upgrade path)
npx create-booboo my-brain
cd my-brain
npm install
npm run build                    # booboo.config.yaml → brain.json (the snapshot)
npm run serve                    # REST API on http://localhost:8787
npm run mcp                      # MCP over stdio — point Claude / Cursor / Claude Code at it

Edita booboo.config.yaml para apuntar a tu propio Postgres/Supabase (un ejemplo comentado se incluye en el scaffold). Referencia completa: docs/CONFIG.md · ¿Atascado? docs/TROUBLESHOOTING.md.

Hoja de ruta: un único comando todo-en-uno que combine build + REST + MCP + el visor 3D, y un asistente interactivo de scaffolding — seguimiento en LAUNCH_CHECKLIST.md.

Qué funciona hoy

booboo build --config booboo.config.yaml    # any postgres/json → one graph snapshot (privacy walls + parent spines)
booboo serve --snapshot my.booboo.json --port 8787   # REST: /graph /stats /search /nodes/:id /neighbors/:id /path/:a/:b
booboo mcp   --snapshot my.booboo.json --org org.booboo.json  # MCP over stdio (+ booboo_boot: agents boot FROM the org)
booboo view  --snapshot my.booboo.json               # 3D viewer in your browser — no monorepo, no build step
booboo panel --org org.booboo.json --snapshot my.booboo.json  # THE ORGANIGRAM — see below
booboo vault --snapshot my.booboo.json --org org.booboo.json --out vault  # the brain as a markdown vault — see below

booboo view sirve el renderizador 3D @booboo-brain/viewer como aplicación independiente — cualquier snapshot (o ?n=1000000 sintético) en tu navegador, sin monorepo. El motor de build fue probado en un cerebro de producción real de 4.469 nodos ensamblado directamente desde Supabase solo con configuración — con muros de privacidad, validado, servido. Consulta el README de cada paquete para los detalles.

Conéctalo a Claude / Cursor (MCP)

booboo mcp habla MCP sobre stdio. Apunta cualquier cliente MCP a él — sin servidor que alojar, se ejecuta bajo demanda:

// Claude Desktop: claude_desktop_config.json · Cursor: .cursor/mcp.json · Claude Code: .mcp.json
{
  "mcpServers": {
    "booboo": {
      "command": "npx",
      "args": ["-y", "@booboo-brain/cli", "mcp",
               "--snapshot", "my.booboo.json", "--org", "org.booboo.json"]
    }
  }
}

Tu agente ahora puede consultar todo el sistema — search, neighbors, path, stats — booboo_boot('<agent-id>') devuelve las reglas de un agente, el alcance de su memoria y sus informes para que arranque desde la organización, y booboo_remember / booboo_report le permiten escribir de vuelta memorias e informes duraderos que persisten entre reconstrucciones (el sistema de memoria en vivo). Apunta --snapshot/--org a rutas absolutas si el directorio de trabajo del cliente difiere.

Herramientas

Herramienta	Qué hace
booboo_stats	Conteos de nodos/enlaces para todo el grafo, desglosados por capa.
booboo_count	Solo conteos, sin traer el payload — úsalo al dimensionar una consulta.
booboo_search	Busca nodos por etiqueta o id (ordenado: exacto > prefijo > subcadena). Úsalo primero para encontrar el id de un nodo.
booboo_node	Recupera un solo nodo (todos los campos + datos) por su id exacto.
booboo_neighbors	El vecindario alrededor de un nodo: nodos conectados + enlaces hasta depth saltos.
booboo_path	Camino más corto (cadena de nodos) entre dos ids de nodo; null si es inalcanzable.
booboo_boot (con --org)	La porción de arranque de un agente del organigrama: identidad, cadena de autoridad, reglas heredadas, acceso a buckets, habilidades, hijos. Llámalo primero, en cada sesión.
booboo_org (con --org)	El organigrama completo: cada agente, la jerarquía, buckets y referencias de reglas.
booboo_remember	Escribe una memoria duradera — un hecho atómico, vinculado a un agente. Se añade al diario junto al snapshot; consultable en la misma sesión, sobrevive a cada reconstrucción.
booboo_report	Escribe un informe — lo que un agente acaba de cerrar. Aterriza en la línea de tiempo de Informes del panel.

booboo_remember / booboo_report están activados por defecto — la mitad viva del sistema de memoria. Pasa --no-write (o BOOBOO_READONLY=1) para un servidor de solo lectura (despliegues públicos/bloqueados); aún lee el diario pero rechaza escrituras.

El Organigrama — dirige tus agentes como una empresa

booboo panel abre tu flota de agentes como un organigrama real — y el organigrama no es un diagrama, es la autoridad. Cada agente es una tarjeta: sus reglas, habilidades, acceso a buckets de memoria e informes recientes. Arrastra un agente bajo un nuevo padre, pulsa aplicar, y el archivo de organización cambia — versionado en git, validado antes de cada escritura (un ciclo nunca puede aterrizar). Los agentes que arrancan con booboo_boot obedecen la nueva forma en su próxima sesión. Reorganiza tu empresa en el desayuno; toda la flota lo sabe para el primer café.

la línea de tiempo del portafolio	memoria, bucket por bucket

Cinco pestañas sobre un archivo de organización + un snapshot: organigrama (jerarquía arrastrar-y-soltar) · buckets (quién recuerda qué) · informes (lo que la flota cerró, más reciente primero) · reglas (quién declara, quién hereda) · grafo (el cerebro 3D, integrado). Las reglas se heredan de arriba hacia abajo — declara una vez en una rama, todos los que están debajo quedan vinculados; cada dossier muestra la pila heredada en orden de arranque.

Los informes y buckets se llenan de dos maneras: en vivo, cuando un agente llama a booboo_remember / booboo_report (escrituras duraderas en el diario, sin reconstrucción), o en masa desde tus propias tablas vía configuración — consulta docs/CONFIG.md § Cableando informes y memoria de la flota.

La bóveda — tu cerebro como markdown plano (listo para Obsidian)

booboo vault emite el mismo snapshot como una bóveda markdown con enlaces wiki: una página por nodo con frontmatter y sus enlaces, páginas de índice por capa y clúster, un dossier de agente por miembro de la organización (cadena de mando, reglas heredadas, buckets, máquinas, contrato). Abre la carpeta como una bóveda de Obsidian y tienes el patrón de "segundo cerebro LLM" — excepto que se genera desde tu sistema real en lugar de notas alimentadas a mano. Los archivos planos son la portabilidad definitiva: cualquier humano puede leerlos, cualquier agente de cualquier proveedor también. Emítelo cada noche y la bóveda sirve como tu copia de seguro.

Autoriza enlaces tú mismo: pon referencias [[node-id]] (o [[exact label]]) dentro del texto de una nota y establece wikilinks: true en la configuración — el constructor las convierte en aristas authored de primera clase que superan a las relaciones cosechadas, en el grafo, la API, la vista 3D y la bóveda. Cada build también imprime una línea de calidad de ingesta (authored · orphans · dump-suspects) para que la curación sea un número, no una vibra.

Tu agente sabe qué hacer — el contrato viaja con el scaffold

npx create-booboo genera AGENTS.md (importado por CLAUDE.md) en el proyecto: la doctrina operativa que cualquier agente de IA que trabaje en esa carpeta lee automáticamente — arranca desde la organización, un hecho atómico por nota, autoriza tus [[links]], las correcciones reemplazan, respeta los muros, vigila el umbral de calidad, cierra con honestidad. Una instalación nueva deja a tu agente ya fluido en las convenciones del cerebro; edita el archivo a medida que tus propias reglas evolucionan — es la constitución de tu sistema, versionada junto a la organización.

Por qué es diferente

Lo más parecido en GitHub hace una capa cada uno — buenas herramientas, todas, para su porción:

	Vista de todo el sistema	API REST	MCP (los agentes lo consultan)	3D a 1M nodos	Muros de privacidad
Booboo	✅	✅	✅	✅	✅
Visores de grafos (3d-force-graph)	solo render	—	—	✅	—
Grafos de notas (Obsidian, Logseq)	tus notas, no tu sistema (booboo emite una bóveda Obsidian: booboo vault)	—	plugins	—	—
Frameworks de agentes (LangGraph, trazas)	flujos y ejecuciones	✅	parcial	—	—
Almacenes de memoria (Graphiti, Cognee)	solo memoria	✅	✅	—	—

Ninguno fusiona cableado + conocimiento + memoria episódica + agentes + crons en un único cerebro enraizado, vivo y arrancable que sea simultáneamente una vista, un fondo de pantalla, una API y una fuente MCP. Esa fusión operativa es la parte novedosa.

Llave en mano (opcional — todo lo anterior sigue siendo gratis)

Cada función es MIT y siempre lo será. Si prefieres no hacer la configuración tú mismo, Fractional HQ mapea tu stack: adaptadores personalizados, snapshot alojado, pipeline de actualización. Mismo repositorio, mismo esquema de configuración, nunca un fork, nunca una barrera.

Licencia

MIT — construido para ser bifurcado, adaptado y enviado. Por Fractional HQ.