Booboo

🐾 Booboo — o cérebro operacional unificado

Transforme os dados de qualquer sistema de IA em um cérebro 3D vivo e enraizado — estrutura + conhecimento + memória + agentes + automações fundidos em um único grafo. Consulte-o via REST ou MCP, visualize-o no seu navegador ou como papel de parede da área de trabalho e inicialize seus agentes a partir dele com uma única chamada.

Veja antes de instalar → booboo.fractionalhq.uk · um cérebro vivo no seu navegador, sem cadastro, nada para clonar.

Nomeado em homenagem a um dachshund que nunca esquece onde os petiscos estão enterrados. Apropriado, porque Booboo é exatamente sobre isso: memória e recordação — ver o sistema inteiro de uma vez, buscar o que está enterrado, nunca perder o fio da meada.

Sem retoques: booboo view --demo --nodes 50000 — 50 mil nós, 4 camadas, ao vivo em uma aba do navegador, zero erros no console. Experimente você mesmo com um único comando.

A maioria das ferramentas mostra apenas uma fatia: um grafo de conhecimento, um fluxograma de agentes, um armazenamento de memória, um visualizador de rastreamento. Booboo funde todos eles em um único grafo enraizado em um único ponto, para que você possa ver — e consultar — como o sistema inteiro realmente se conecta.

Status: alpha — oito pacotes publicados: @booboo-brain/spec (o contrato), @booboo-brain/build (adaptadores postgres/json orientados por configuração), @booboo-brain/serve (camada de consulta REST + MCP), @booboo-brain/viewer (renderização 3D de milhões de nós), @booboo-brain/panel (o organograma), @booboo-brain/vault (exportação markdown com links wiki), @booboo-brain/cli (o comando unificado booboo) e create-booboo (gerador de projetos). Semver por pacote — veja cada package.json. MIT.

---

A ideia central

Booboo é uma especificação JSON minúscula no centro, com adaptadores que a alimentam e consumidores que renderizam/servem/consultam:

  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)

Emita o JSON → obtenha o visualizador, a API e o servidor MCP de graça. Dados estranhos → um adaptador de ~50 linhas, não um fork. Veja SPEC.md.

Início rápido

Um único comando. Sem banco de dados, sem configuração, sem cadastro. Um cérebro sintético, rodando na sua máquina:

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

Essa é a grande sacada: um milhão de nós a 60fps em uma aba do navegador. Reduza a contagem para --nodes 50000 em um laptop modesto. Veja SCALE.md para saber como ele se comporta (uma única chamada de desenho sobre uma única nuvem de pontos com um shader personalizado, além de LOD em camadas nos rótulos).

Se funcionar bem na sua máquina, deixe uma estrela. Não há marketing por trás deste repositório; estrelas são como o próximo desenvolvedor o encontra.

Depois aponte para sua própria 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

Edite booboo.config.yaml para apontar para seu próprio Postgres/Supabase (um exemplo comentado acompanha o scaffold). Referência completa: docs/CONFIG.md · travou? docs/TROUBLESHOOTING.md.

Roadmap: um único comando all-in-one que combina build + REST + MCP + o visualizador 3D, e um assistente interativo de scaffold — acompanhado em LAUNCH_CHECKLIST.md.

O que funciona hoje

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 serve o renderizador 3D @booboo-brain/viewer como um aplicativo autônomo — qualquer snapshot (ou ?n=1000000 sintético) no seu navegador, sem monorepo. O motor de build foi comprovado em um cérebro de produção real com 4.469 nós montado diretamente do Supabase apenas por configuração — com paredes de privacidade, validado, servido. Veja o README de cada pacote para os detalhes.

Conecte ao Claude / Cursor (MCP)

booboo mcp fala MCP via stdio. Aponte qualquer cliente MCP para ele — sem servidor para hospedar, ele roda sob 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"]
    }
  }
}

Seu agente agora pode consultar o sistema inteiro — search, neighbors, path, stats — booboo_boot('<agent-id>') retorna as regras de um agente, alcance de memória e relatórios para que ele inicialize a partir da organização, e booboo_remember / booboo_report permitem escrever de volta memórias duráveis e relatórios que persistem entre rebuilds (o sistema de memória viva). Aponte --snapshot/--org para caminhos absolutos se o diretório de trabalho do cliente for diferente.

Ferramentas

Ferramenta	O que faz
booboo_stats	Contagens de nós/links para o grafo inteiro, divididas por camada.
booboo_count	Apenas contagens, sem puxar o payload — use ao dimensionar uma consulta.
booboo_search	Busca nós por rótulo ou id (ranqueada: exato > prefixo > substring). Use primeiro para encontrar o id de um nó.
booboo_node	Busca um único nó (todos os campos + dados) pelo id exato.
booboo_neighbors	A vizinhança ao redor de um nó: nós conectados + links até depth saltos.
booboo_path	Caminho mais curto (cadeia de nós) entre dois ids de nós; null se inalcançável.
booboo_boot (com --org)	A fatia de inicialização de um agente no organograma: identidade, cadeia de autoridade, regras herdadas, acesso a buckets, habilidades, filhos. Chame primeiro, em toda sessão.
booboo_org (com --org)	O organograma completo: todos os agentes, a hierarquia, buckets e referências de regras.
booboo_remember	Escreve uma memória durável — um fato atômico, vinculado a um agente. Anexado ao diário ao lado do snapshot; consultável na mesma sessão, sobrevive a todo rebuild.
booboo_report	Escreve um relatório — o que um agente acabou de encerrar. Cai na linha do tempo de Relatórios do painel.

booboo_remember / booboo_report estão ativados por padrão — a metade viva do sistema de memória. Passe --no-write (ou BOOBOO_READONLY=1) para um servidor somente leitura (implantações públicas/bloqueadas); ele ainda lê o diário, mas recusa escritas.

O Organograma — gerencie seus agentes como uma empresa

booboo panel abre sua frota de agentes como um organograma real — e o organograma não é um diagrama, é a autoridade. Cada agente é um cartão: suas regras, habilidades, acesso a buckets de memória e relatórios mais recentes. Arraste um agente para baixo de um novo pai, clique em aplicar, e o arquivo da organização muda — versionado no git, validado antes de toda escrita (um ciclo nunca pode ser aplicado). Agentes que inicializam com booboo_boot obedecem à nova estrutura na próxima sessão. Reorganize sua empresa no café da manhã; toda a frota sabe antes do primeiro café.

a linha do tempo do portfólio	memória, bucket por bucket

Cinco abas sobre um arquivo de organização + um snapshot: organograma (hierarquia arrastar-e-soltar) · buckets (quem lembra do quê) · relatórios (o que a frota encerrou, do mais recente ao mais antigo) · regras (quem declara, quem herda) · grafo (o cérebro 3D, embutido). Regras são herdadas de cima para baixo — declare uma vez em um ramo, todos abaixo estão vinculados; cada dossiê mostra a pilha herdada na ordem de inicialização.

Relatórios e buckets se preenchem de duas formas: ao vivo, quando um agente chama booboo_remember / booboo_report (escritas duráveis no diário, sem rebuild), ou em massa a partir das suas próprias tabelas via configuração — veja docs/CONFIG.md § Wiring fleet reports & memory.

O cofre — seu cérebro como markdown simples (pronto para Obsidian)

booboo vault emite o mesmo snapshot como um cofre markdown com links wiki: uma página por nó com frontmatter e seus links, páginas de índice por camada e cluster, um dossiê de agente por membro da organização (cadeia de comando, regras herdadas, buckets, máquinas, contrato). Abra a pasta como um cofre Obsidian e você tem o padrão "segundo cérebro para LLM" — exceto que é gerado a partir do seu sistema real em vez de notas alimentadas manualmente. Arquivos simples são a portabilidade definitiva: qualquer humano pode lê-los, qualquer agente de qualquer provedor também. Emita-o diariamente e o cofre dobra como sua cópia de segurança.

Autorize links você mesmo: coloque referências [[node-id]] (ou [[exact label]]) dentro do texto de uma nota e defina wikilinks: true na configuração — o builder as transforma em arestas authored de primeira classe que superam relações colhidas, no grafo, na API, na visualização 3D e no cofre. Todo build também imprime uma linha de qualidade de ingestão (authored · orphans · dump-suspects) para que a curadoria seja um número, não uma sensação.

Seu agente sabe o que fazer — o contrato acompanha o scaffold

npx create-booboo gera AGENTS.md (importado por CLAUDE.md) no projeto: a doutrina operacional que qualquer agente de IA trabalhando naquela pasta lê automaticamente — inicialize a partir da organização, um fato atômico por nota, autorize seus [[links]], correções substituem, respeite as paredes, observe o portão de qualidade, encerre honestamente. Uma instalação nova deixa seu agente já fluente nas convenções do cérebro; edite o arquivo conforme suas próprias regras evoluem — é a constituição do seu sistema, versionada ao lado da organização.

Por que é diferente

As coisas mais próximas no GitHub cada uma faz uma camada — boas ferramentas, todas elas, para sua fatia:

	Visão do sistema inteiro	API REST	MCP (agentes consultam)	3D com 1M de nós	Paredes de privacidade
Booboo	✅	✅	✅	✅	✅
Visualizadores de grafo (3d-force-graph)	apenas renderização	—	—	✅	—
Grafos de notas (Obsidian, Logseq)	suas notas, não seu sistema (booboo emite um cofre Obsidian: booboo vault)	—	plugins	—	—
Frameworks de agentes (LangGraph, traces)	fluxos e execuções	✅	parcial	—	—
Armazenamentos de memória (Graphiti, Cognee)	apenas memória	✅	✅	—	—

Nenhum funde conexões + conhecimento + memória episódica + agentes + crons em um único cérebro enraizado, vivo e inicializável que é simultaneamente uma visualização, um papel de parede, uma API e uma fonte MCP. Essa fusão operacional é a parte inovadora.

Chave na mão (opcional — tudo acima continua gratuito)

Cada recurso é MIT e sempre será. Se você preferir não fazer a configuração você mesmo, Fractional HQ mapeia sua stack: adaptadores personalizados, snapshot hospedado, pipeline de atualização. Mesmo repositório, mesmo esquema de configuração, nunca um fork, nunca um portão.

Licença

MIT — construído para ser bifurcado, adaptado e enviado. Por Fractional HQ.