Bonnard

[!IMPORTANT] Este repositorio está archivado y ya no se mantiene. Formaba parte de una versión anterior de Bonnard. Nuestros productos actuales están en bonnard.dev. Comienza con @bonnard/mcp-charts. Preguntas: pierre@bonnard.dev

Analítica nativa para agentes. Un esquema, múltiples superficies.

Documentación · Primeros pasos · Registro de cambios · Discord · Sitio web

---

Las herramientas de BI sirven a una interfaz. Bonnard sirve a todo. Agentes a través de MCP, aplicaciones a través del SDK, paneles en markdown, herramientas internas vía REST. Un solo conjunto de definiciones de métricas, cada consumidor obtiene la misma respuesta gobernada.

## ¿Por qué Bonnard?

Las capas semánticas tradicionales fueron construidas para paneles y adaptadas para IA. Los agentes obtienen respuestas diferentes a las de los paneles, las métricas se desvían entre herramientas, y cada nueva superficie significa otra integración. Bonnard fue construido nativo para agentes desde el primer día. MCP es una característica central, no un complemento. Un solo CLI, un esquema, cada consumidor obtiene la misma respuesta gobernada.

Inicio rápido

No requiere instalación. Ejecuta directamente con npx:

npx @bonnard/cli init

O instala globalmente:

npm install -g @bonnard/cli

Luego sigue el flujo de configuración:

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

Tu capa semántica ya está activa. Los agentes, los paneles y el SDK consultan las mismas métricas gobernadas.

¿Aún no tienes un almacén de datos? Comienza a explorar con un conjunto de datos de demostración minorista completo:

bon datasource add --demo

Requiere Node.js 20+.

Lo que obtienes

• Contexto para agentes listo para usar. bon init genera reglas y habilidades para Claude Code, Cursor y Codex para que los agentes comprendan tu capa semántica desde el primer mensaje.
• Servidor MCP para consultas gobernadas de agentes. Configúralo con bon mcp, pruébalo con bon mcp test.
• Paneles en markdown con componentes BigValue, LineChart, BarChart, AreaChart, PieChart y DataTable. Previsualiza localmente con bon dashboard dev, despliega con bon dashboard deploy.
• Consultas JSON y SQL desde la terminal vía bon query y bon schema, o programáticamente a través de la API REST.
• Versionado de despliegues con seguimiento de cambios (bon diff), anotaciones (bon annotate) e historial completo (bon deployments).
• Soporte CI/CD. Ejecuta bon deploy --ci -m "message" para pipelines no interactivos.

Fuentes de datos compatibles

Almacenes: Snowflake (incluido Snowpark), Google BigQuery, Databricks (SQL warehouses y Unity Catalog), PostgreSQL (incluidos Supabase, Neon y RDS), Amazon Redshift, DuckDB (incluido MotherDuck)

Herramientas de datos: dbt (importación de modelos y perfiles), Dagster, Prefect, Airflow (orquestación), Looker, Cube, Evidence (capas de BI existentes), SQLMesh, Soda, Great Expectations (calidad de datos)

Bonnard detecta automáticamente tus almacenes y herramientas de datos. Apúntalo a tu proyecto y descubre esquemas, tablas y relaciones.

Ecosistema

• @bonnard/sdk: consulta la capa semántica desde cualquier aplicación JavaScript o TypeScript
• @bonnard/react: componentes de gráficos React y un visor de paneles en markdown

Comandos

Comando	Descripción
bon init	Crea un nuevo proyecto con configuraciones de agentes
bon datasource add	Conecta una fuente de datos (o --demo para datos de muestra)
bon validate	Valida la sintaxis YAML localmente
bon deploy -m "message"	Despliega a producción
bon pull	Descarga modelos desplegados al proyecto local
bon query	Ejecuta consultas (JSON o SQL)
bon schema	Explora medidas, dimensiones y vistas desplegadas
bon dashboard dev	Previsualiza un panel en markdown localmente
bon dashboard deploy	Despliega un panel
bon mcp	Instrucciones de configuración del servidor MCP
bon keys create	Crea una clave API publicable o secreta
bon docs	Navega por la documentación desde el CLI

Consulta la referencia completa del CLI para todos los comandos y banderas.

Documentación

Guía	Descripción
Primeros pasos	De cero a desplegado en minutos
Referencia del CLI	Cada comando, bandera y opción
Guía de modelado	Cubos, vistas, métricas y dimensiones
Paneles	Paneles en markdown con gráficos, entradas y temas
SDK	SDK de TypeScript y componentes React
Consultas	Sintaxis de consultas JSON y SQL
Registro de cambios	Qué se lanzó y cuándo

Comunidad

• Discord: haz preguntas, comparte comentarios, conéctate con el equipo
• GitHub Issues: informes de errores y solicitudes de funciones
• LinkedIn: sigue para actualizaciones
• Sitio web: aprende más sobre Bonnard

Las contribuciones son bienvenidas. Si encuentras un error o tienes una idea, abre un issue o envía un pull request.