AI/TLDR

dbt Labs · 2026-09-14 · major

dbt Charts — dashboards as YAML, so an agent can write them

dbt Charts is an Apache-2.0 language from dbt Labs that describes a full interactive dashboard in one YAML file. It exists because AI agents write good code but bad BI clicks, so the dashboard becomes a file you can review in a pull request.

dbt Charts announcement banner from dbt Labs

One YAML file describes a whole interactive dashboard, so charts live in Git next to the models they read.

Quick facts

Makerdbt Labs
LicenseApache-2.0
Installuv tool install dbt-charts
CLIdct
Chart types16, plus composed charts
Export formatsHTML, PDF, PNG, SVG, JSON
Hosted servicedbtCharts.com, public beta

What is it?

dbt Charts puts the dashboard itself into a YAML file instead of a BI tool's click-through editor. The file names the SQL queries, the chart types, and the row-and-column layout, and the engine turns it into an interactive board. dbt Labs released the language, the engine and the dct CLI under Apache-2.0 on 14 September 2026, alongside a hosted dbtCharts.com platform in public beta.

How does it work?

SQL still says WHAT data to pull; the YAML layer says HOW to show it. You declare queries (inline values, raw SQL, or dbt ref() and source() calls), then charts that map columns to a visual, then rows and cols for layout. The dct CLI validates a board without touching the warehouse, serves a live preview with working filters, and renders to HTML, PDF, PNG, SVG or JSON. Sixteen chart types ship built in, along with five themes.

Why does it matter?

Handing an agent a BI tool means handing it a mouse. Dave Fowler's announcement argues that when you instead ask an agent for a dashboard, you get a pile of HTML, CSS and JavaScript nobody wants to review. A single readable YAML file is diffable, so a change to a dbt model and a change to the chart that reads it ship on the same branch through the same CI run.

Who is it for?

analytics engineers and data teams using AI agents

Frequently asked questions

Is dbt Charts free and open source?
dbt Charts ships its YAML language, rendering engine and dct CLI under the Apache-2.0 licence, so the whole local workflow is free. dbtCharts.com is a separate hosted product, currently in public beta, that adds hosting, access control and a UI on top of the same open language.
Do you need dbt to use dbt Charts?
No. The dbt Charts documentation states that dbt is optional and that the tool works with plain SQL. If you do run dbt, boards can call ref() and source() to point at your existing models, which is what keeps charts and models in one repo on one branch.
Which databases does dbt Charts work with?
dbt Charts supports DuckDB and SQLite out of the box and adds Postgres, Snowflake, BigQuery, Redshift, Databricks, Spark and Trino through warehouse extras such as uv tool install "dbt-charts[snowflake]". Local CSV and Parquet files also work. Python 3.10 or newer is required.
What does dbtCharts.com add over the open-source CLI?
The hosted dbtCharts.com platform layers conversational analytics, a visual editor, version history and permissioned sharing over the open-source language. Sharing is the practical difference: people and groups can open a board without having their own warehouse login. It is in public beta.

Try it

uv tool install dbt-charts && dct skills intro

Sources · 3 outlets

Tags

  • dbt
  • dbt-charts
  • dashboards
  • business-intelligence
  • yaml
  • sql
  • open-source
  • apache-2-0
  • ai-agents
  • data-engineering
  • cli
  • python

← All releases · Learn AI