Bonnard

Ultra-fast to deploy agentic-first mcp-ready semantic layer. Let your data be like water.

GitHub

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

Agent-native analytics. One schema, many surfaces.

npm version MIT License Discord

Docs · Getting Started · Changelog · Discord · Website

BI tools serve one UI. Bonnard serves everything. Agents over MCP, apps over SDK, dashboards in markdown, internal tools via REST. One set of metric definitions, every consumer gets the same governed answer.

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

## Why Bonnard?

Traditional semantic layers were built for dashboards and retrofitted for AI. Agents get different answers than dashboards, metrics drift across tools, and every new surface means another integration. Bonnard was built agent-native from day one. MCP is a core feature, not a plugin. One CLI, one schema, every consumer gets the same governed answer.

Quick Start

No install required. Run directly with npx:

npx @bonnard/cli init

Or install globally:

npm install -g @bonnard/cli

Then follow the setup flow:

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

Your semantic layer is now live. Agents, dashboards, and the SDK all query the same governed metrics.

No warehouse yet? Start exploring with a full retail demo dataset:

bon datasource add --demo

Requires Node.js 20+.

What You Get

  • Agent context out of the box. bon init generates rules and skills for Claude Code, Cursor, and Codex so agents understand your semantic layer from the first prompt.
  • MCP server for governed agent queries. Set up with bon mcp, test with bon mcp test.
  • Markdown dashboards with BigValue, LineChart, BarChart, AreaChart, PieChart, and DataTable components. Preview locally with bon dashboard dev, deploy with bon dashboard deploy.
  • JSON and SQL querying from the terminal via bon query and bon schema, or programmatically via the REST API.
  • Deployment versioning with change tracking (bon diff), annotations (bon annotate), and full history (bon deployments).
  • CI/CD support. Run bon deploy --ci -m "message" for non-interactive pipelines.

Supported Data Sources

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

Data tools: dbt (model and profile import), Dagster, Prefect, Airflow (orchestration), Looker, Cube, Evidence (existing BI layers), SQLMesh, Soda, Great Expectations (data quality)

Bonnard auto-detects your warehouses and data tools. Point it at your project and it discovers schemas, tables, and relationships.

Ecosystem

  • @bonnard/sdk: query the semantic layer from any JavaScript or TypeScript application
  • @bonnard/react: React chart components and a markdown dashboard viewer

Commands

CommandDescription
bon initScaffold a new project with agent configs
bon datasource addConnect a data source (or --demo for sample data)
bon validateValidate YAML syntax locally
bon deploy -m "message"Deploy to production
bon pullDownload deployed models to local project
bon queryRun queries (JSON or SQL)
bon schemaExplore deployed measures, dimensions, and views
bon dashboard devPreview a markdown dashboard locally
bon dashboard deployDeploy a dashboard
bon mcpMCP server setup instructions
bon keys createCreate a publishable or secret API key
bon docsBrowse documentation from the CLI

See the full CLI reference for all commands and flags.

Documentation

GuideDescription
Getting StartedFrom zero to deployed in minutes
CLI ReferenceEvery command, flag, and option
Modeling GuideCubes, views, metrics, and dimensions
DashboardsMarkdown dashboards with charts, inputs, and theming
SDKTypeScript SDK and React components
QueryingJSON and SQL query syntax
ChangelogWhat shipped and when

Community

Contributions are welcome. If you find a bug or have an idea, open an issue or submit a pull request.

Servidores relacionados