Bonnard

Camada semântica ultra-rápida para implantação, pronta para agentes e MCP. Deixe seus dados fluírem como água.

GitHub
50
Experimente este MCPPatrocinado

Documentação

[!IMPORTANT] Este repositório está arquivado e não é mais mantido. Ele fazia parte de uma versão anterior do Bonnard. Nossos produtos atuais estão em bonnard.dev. Comece com @bonnard/mcp-charts. Perguntas: pierre@bonnard.dev

Bonnard: agent-native analytics. One schema, many surfaces.

Analytics nativo para agentes. Um schema, várias superfícies.

npm version MIT License Discord

Documentação · Primeiros Passos · Changelog · Discord · Site

Ferramentas de BI atendem a uma única interface. O Bonnard atende a tudo. Agentes via MCP, aplicativos via SDK, dashboards em markdown, ferramentas internas via REST. Um conjunto de definições de métricas, e cada consumidor recebe a mesma resposta governada.

Bonnard architecture -data sources flow through the semantic layer to AI agents, BI tools, and MCP clients

## Por que Bonnard?

As camadas semânticas tradicionais foram construídas para dashboards e adaptadas para IA. Os agentes recebem respostas diferentes dos dashboards, as métricas divergem entre as ferramentas, e cada nova superfície significa outra integração. O Bonnard foi construído nativamente para agentes desde o primeiro dia. MCP é um recurso central, não um plugin. Um CLI, um schema, e cada consumidor recebe a mesma resposta governada.

Início Rápido

Sem necessidade de instalação. Execute diretamente com npx:

npx @bonnard/cli init

Ou instale globalmente:

npm install -g @bonnard/cli

Em seguida, siga o fluxo de configuração:

bon init                      # Scaffold project + agent configs
bon datasource add            # Connect your warehouse
bon validate                  # Check your models locally
bon login                     # Authenticate
bon deploy -m "initial deploy" # Ship it

Sua camada semântica agora está ativa. Agentes, dashboards e o SDK consultam as mesmas métricas governadas.

Ainda não tem um warehouse? Comece a explorar com um conjunto completo de dados de demonstração de varejo:

bon datasource add --demo

Requer Node.js 20+.

O Que Você Obtém

  • Contexto para agentes pronto para uso. bon init gera regras e habilidades para Claude Code, Cursor e Codex para que os agentes entendam sua camada semântica desde o primeiro prompt.
  • Servidor MCP para consultas governadas por agentes. Configure com bon mcp, teste com bon mcp test.
  • Dashboards em Markdown com componentes BigValue, LineChart, BarChart, AreaChart, PieChart e DataTable. Visualize localmente com bon dashboard dev, implante com bon dashboard deploy.
  • Consultas JSON e SQL a partir do terminal via bon query e bon schema, ou programaticamente via API REST.
  • Versionamento de implantação com rastreamento de alterações (bon diff), anotações (bon annotate) e histórico completo (bon deployments).
  • Suporte a CI/CD. Execute bon deploy --ci -m "message" para pipelines não interativos.

Fontes de Dados Suportadas

Warehouses: Snowflake (incluindo Snowpark), Google BigQuery, Databricks (SQL warehouses e Unity Catalog), PostgreSQL (incluindo Supabase, Neon e RDS), Amazon Redshift, DuckDB (incluindo MotherDuck)

Ferramentas de dados: dbt (importação de modelos e perfis), Dagster, Prefect, Airflow (orquestração), Looker, Cube, Evidence (camadas de BI existentes), SQLMesh, Soda, Great Expectations (qualidade de dados)

O Bonnard detecta automaticamente seus warehouses e ferramentas de dados. Aponte-o para seu projeto e ele descobre schemas, tabelas e relacionamentos.

Ecossistema

  • @bonnard/sdk: consulte a camada semântica a partir de qualquer aplicativo JavaScript ou TypeScript
  • @bonnard/react: componentes de gráficos React e um visualizador de dashboards em markdown

Comandos

ComandoDescrição
bon initCrie um novo projeto com configurações de agente
bon datasource addConecte uma fonte de dados (ou --demo para dados de exemplo)
bon validateValide a sintaxe YAML localmente
bon deploy -m "message"Implante em produção
bon pullBaixe modelos implantados para o projeto local
bon queryExecute consultas (JSON ou SQL)
bon schemaExplore medidas, dimensões e visualizações implantadas
bon dashboard devVisualize um dashboard em markdown localmente
bon dashboard deployImplante um dashboard
bon mcpInstruções de configuração do servidor MCP
bon keys createCrie uma chave de API publicável ou secreta
bon docsNavegue pela documentação a partir do CLI

Consulte a referência completa do CLI para todos os comandos e flags.

Documentação

GuiaDescrição
Primeiros PassosDo zero à implantação em minutos
Referência do CLICada comando, flag e opção
Guia de ModelagemCubos, visualizações, métricas e dimensões
DashboardsDashboards em markdown com gráficos, entradas e temas
SDKSDK TypeScript e componentes React
ConsultasSintaxe de consulta JSON e SQL
ChangelogO que foi lançado e quando

Comunidade

  • Discord: faça perguntas, compartilhe feedback, conecte-se com a equipe
  • GitHub Issues: relatórios de bugs e solicitações de recursos
  • LinkedIn: siga para atualizações
  • Site: saiba mais sobre o Bonnard

Contribuições são bem-vindas. Se você encontrar um bug ou tiver uma ideia, abra uma issue ou envie um pull request.