You write ordinary DuckDB SQL and tag result columns with ::ROLE casts. Each
annotated SELECT becomes a chart, a KPI, a table or an input, rendered to SVG
by ggplot-rs, a grammar-of-graphics
engine. There is no JavaScript charting library and no config file: the SQL is
the dashboard.
Important
Early development: expect bugs and breaking changes. Please report them on the issues page.
SELECT week::XAXIS, channel::CATEGORY, sum(revenue)::BARCHART_STACKED, 'Revenue by channel'::TITLE
FROM sales GROUP BY ALL ORDER BY ALL;▶ Try it in the browser: the builder runs on DuckDB-Wasm, nothing to install.
- Draw charts in SQL. 36 chart kinds (bars, lines, scatter, heatmaps, waterfalls, Sankey, Gantt, diagrams and factor graphs …) and maps (countries and regions built in, or your own geometry), as SVG from any query. Chart catalogue
- Build dashboards from a
.sqlfile. KPI tiles, tables, inputs (getvariable), tabs, cross-filtering, drill-down and share links. Building dashboards - Author in the browser. The builder edits and renders on DuckDB-Wasm or against your own database (
anofox_serve). Authoring - Publish without a server. Static HTML, one SVG, or a whole static site (
dashboard --site). Static site - Serve dashboards to others. A locked, read-only server with login (OIDC, JWT, proxy, API keys), row and column policies, scheduled reports and alerts. Locked server
- Embed them in your own app (a web component, or signed embed links). Embedding
- Plot results from the anofox extensions. statistics, forecast, tabular, optimize and decide:
anofox_plot(t)picks the plot. From Python and R too. Integrations - Check dashboards in CI.
dashboard --checkfinds broken panels, design problems and implausible numbers. CLI - Add your own features as modules or plugins. Your own roles, panels, SQL macros and browser files from a separate (also private) crate: built into your own distribution, or compiled to one sandboxed
.wasmplugin and loaded with--plugin. Modules and plugins
- The community extension only renders.
INSTALL … FROM communitygives SQL → SVG. The server, the builder and thedashboard/serveCLIs come with a GitHub release or a source build. - Release files are unsigned. Load them with
duckdb -unsigned; each release has checksums and build attestations. - DuckDB 1.5.6 is the release target. 2.0 is built and tested in CI (non-blocking); the pin moves with 2.0.1.
- No drag-and-drop. Dashboards are SQL. The builder helps you write it; it doesn't hide it.
- The AI assistant is off unless an installation turns it on, and it then uses your own Claude API key. It is still being evaluated.
- Plugins are new. The
dashboardCLI,serve(builds with thepluginsfeature) and the browser builder load them; the DuckDB extension follows (#1213). The release builds don't enable them yet, and the interface may still change.
INSTALL anofox_visualization FROM community;
LOAD anofox_visualization;
-- one SVG per group, from columns
WITH sales AS (SELECT * FROM (VALUES ('app', 30), ('web', 22), ('api', 12)) t(ch, n))
SELECT anofox_bar(ch, n) FROM sales;
-- model output from an anofox extension: the plot is picked from the table
SELECT anofox_plot(c) FROM coefficients c;With the full toolkit (a release or a source build):
SELECT anofox_serve(8080); -- the builder on this database (loopback)
SELECT anofox_serve_dashboards('dashboards', 8095); -- serve a folder of .sql dashboards, lockeddashboard my_dashboard.sql out.html # a static, interactive HTML file
dashboard --check my_dashboard.sql # lint it| You want | Get | |
|---|---|---|
| SQL → SVG in any DuckDB | INSTALL anofox_visualization FROM community |
render only |
| The full toolkit: builder, server, CLIs | the latest release (Linux, macOS, Windows) | install guide |
| To build it yourself | duckext/scripts/build-native.sh (Rust stable) |
BUILD.md |
- Website: getting started, the chart catalogue, the gallery, deployment guides.
- docs/DOCS.md: the full reference (every role, the CLI, serving, telemetry of the anofox extensions).
- Dashboard design: what
--checkenforces, and why. - Secure serving and deployment: the trust model, logins, Docker, reverse proxies.
- Python & R: plot statsmodels, scikit-learn or broom results.
- Integration CI: how every anofox extension's output is rendered on every push.
- Writing a module or a plugin.
Five skills that document the SQL API, so Claude Code can write charts and dashboards from a plain request:
/plugin marketplace add DataZooDE/anofox-visualization
/plugin install anofox-visualization@anofox-visualization
The skills live in plugins/anofox-visualization/; every SQL block in them runs in CI.
This extension sends nothing. It also switches off the usage telemetry of the
anofox extensions it loads, unless you set DATAZOO_DISABLE_TELEMETRY=0
(details).
Business Source License 1.1: free for development, testing, research and internal use; hosted or embedded use for third parties needs a commercial license until the Change Date (five years after publication), when it becomes MPL 2.0. Contact contact@datazoo.de.
The plugin SDK (crates/anofox-viz-plugin) and the example plugin
(examples/plugins/hello) are under MIT OR Apache-2.0, so a plugin built
with them can be shipped under any licence.
Pull requests are welcome (cargo test, and dashboard --check for example
dashboards). Questions and bugs: issues,
discussions, or
contact@datazoo.de. If a chart renders wrong, the SQL (or the spec you passed)
is the fastest path to a fix.
A daily banner in interactive terminals asks for a star; silence it with
SET datazoo_banner = false; or DATAZOO_NO_BANNER=1.
@software{anofox_visualization,
title = {Anofox Visualization: Charts & Dashboards for DuckDB from SQL},
author = {DataZoo DE},
year = {2025},
url = {https://github.com/DataZooDE/anofox-visualization}
}