v4.0.0

✨ AVA 4.0 — Visual Analytics for AI Agents

Give your AI agents the tools to connect data, execute analysis, and turn results into charts—with answers you can inspect.

Website · Try it online · Agent Skill

What’s new

• 🔌 Unified data access — Connect files and databases with shared schema, profiling, and business context.
• 🔎 Traceable analysis — Inspect executed queries and results, with Direct and Loop strategies.
• 📊 Smart visualization — Generate charts guided by your question and data, powered by GPT-Vis.
• 💻 Flexible execution — Choose your model provider and local, remote, or custom execution engines.
• 🎯 Published benchmarks — 93.01% accuracy on DataBench with GLM-5.1, DuckDB, Direct, and semantic context. Results →
• 🤖 Agent integration — Use AVA through an Agent Skill, CLI, or TypeScript / JavaScript SDK.

Get started

# Node.js 22.13+
npm install @antv/ava@4

# Add the Agent Skill
npx skills add antvis/AVA --skill ava

Thanks to everyone who helped shape AVA 4.0! ❤️

📋 Full release notes

What's Changed

• feat: add AVA CLI for one-shot data analysis by @yvonneyx in #968
• feat: add DuckDB and PostgreSQL query dialects with read-only SQL validation by @yvonneyx in #971
• feat: add configurable analysis strategy and SQL usage tracking by @yvonneyx in #973
• fix: use native field types in schema metadata by @yvonneyx in #976
• feat: add DataBench evaluation workflow by @yvonneyx in #975
• feat(evals): add direct strategy report for GLM-5.1 by @yvonneyx in #977
• fix: reduce missing DataBench results from 242 to 83 by @yvonneyx in #978
• feat: add bounded query results with row and size limits by @yvonneyx in #979
• feat: define a comprehensive schema for multi-table datasets by @yvonneyx in #981
• feat: implement loop analysis strategy by @yvonneyx in #980
• feat: add DuckDB data profiling and support metric extensions by @yvonneyx in #982
• feat: add SQLite data source support via DuckDB by @yvonneyx in #984
• feat: add data profiling for Interpreter and Supabase engines by @yvonneyx in #983
• feat: enrich model context with data profile by @yvonneyx in #985
• feat: add Jev-powered subset analysis strategy by @yvonneyx in #986
• feat: align SDK APIs by @yvonneyx in #989
• feat(cli): add session-based commands aligned with the AVA API by @yvonneyx in #991
• Harden vulnerable dependency paths in core and site spreadsheet imports by @hustcc with @Copilot in #990
• feat: AVA skill for CLI-based data analysis by @yvonneyx in #993
• Add AVA agent evaluation by @yvonneyx in #994
• Add MongoDB data source support to the v4 DuckDB loading path by @yvonneyx with @Copilot in #995
• Add ClickHouseEngine support with direct ClickHouse schema/query/profile flow by @yvonneyx with @Copilot in #996
• Implement event emission by @yvonneyx in #998
• refactor: reorganize directory structure by @yvonneyx in #1000
• refactor(interpreter): 将代码执行改为异步并支持浏览器沙箱 by @hustcc in #1001
• feat: add pandas-based Python analysis engine by @yvonneyx in #1002
• refactor: reorganize JavaScript and Python interpreter engines by @yvonneyx in #1003
• feat: support CLI engine selection and refine the AVA skill by @yvonneyx in #1004
• feat: add AVA skill marketplace and integration guide by @yvonneyx in #1005
• Rewrite AVA Skills documentation in English by @yvonneyx with @Copilot in #1007
• feat(site): update homepage and documentation by @yvonneyx in #1008
• eval: add Spider 2.0-Lite and BIRD benchmarks by @yvonneyx in #1009
• docs: simplify README by @yvonneyx in #1010
• docs: documentation site by @yvonneyx in #1016
• feat: 更新文档和代码以支持 v4 beta 版本 by @yvonneyx in #1017
• fix: 修复 GB18030 编码 CSV 文件无法导入的问题 by @yvonneyx in #1018
• feat: 支持自定义 JSON 解析参数 by @yvonneyx in #1019
• feat: support Excel sheet selection and reader options by @yvonneyx in #1021
• docs：对话式 AI Playground by @yvonneyx in #1022
• docs: ai 页面细节优化 by @yvonneyx in #1023
• feat: 支持复用 schema/profile 元数据 by @yvonneyx in #1024
• Disable MySQL aggregate pushdown to work around duckdb-mysql by @yvonneyx with @Copilot in #1027
• Structure Supabase remote engine errors by @yvonneyx with @Copilot in #1028
• Rework ava viz skill guide into a decision workflow and switch GPT-Vis rendering from syntax to JSON config by @yvonneyx with @Copilot in #1031
• refactor: 引入 DataModel，整合 schema、profile、semantic by @yvonneyx in #1033
• Add support for semantic metadata by @yvonneyx in #1034
• Add evaluation reports for Spider2-Lite by @yvonneyx in #1036
• Feishu Bitable support with multi-page queries and tests by @Keikeikm in #1032
• Align AI SDK versions in site build by @hustcc with @Copilot in #1037
• feat: add SSH tunnel tests and improve error handling in createSshTunnel by @yvonneyx in #1039
• refactor: simplify Feishu error handling by @yvonneyx in #1038
• Surface open-source status in homepage headline by @yvonneyx with @Copilot in #1041
• Refactor event handling in AVA by @yvonneyx in #1042
• refactor!: remove subset analysis strategy by @yvonneyx in #1044
• docs: update AVA CLI version to 4.0.0-beta.3 in setup documentation by @yvonneyx in #1043
• feat: add analysis step events and structured summaries by @yvonneyx in #1045
• fix(site): upgrade zod to ^4.6.6 by @hustcc with @Copilot in #1048
• docs(agent-skill): 更新 SQL 下载链接为 txt 格式 by @hustcc in #1049
• Export registerEngine and update version to 4.0.0 by @yvonneyx in #1051
• Refactor event handling and usage statistics logic by @yvonneyx in #1053
• feat(site): redesign homepage and refine AI playground by @yvonneyx in #1054
• chore(deps): 升级 zod 至 v4 并适配 API，修复 Vulnerabilities by @hustcc in #1057
• feat: integrate semantic context into AVA skill and CLI by @yvonneyx in #1058
• feat(site): add Chinese pages under /zh by @yvonneyx in #1056
• docs: refine README layout and usage examples by @yvonneyx in #1060
• fix(site): refine homepage layout and stabilize sticky header by @yvonneyx in #1068
• docs(site): clarify analytics, visualization, and benchmark feature copy by @yvonneyx in #1069
• feat(site): add GitHub shortcut and ecosystem showcase announcement by @yvonneyx in #1070
• feat(site): use AntV slogan in footer by @hustcc with @Copilot in #1071
• feat(site): add Google Analytics tracking by @yvonneyx in #1072
• fix(build): generate Node-compatible ESM entry points by @yvonneyx in #1075
• Update data source examples and execution security documentation by @hustcc in #1074

New Contributors

• @yvonneyx made their first contribution in #968
• @Keikeikm made their first contribution in #1032

Full Changelog: v4.0.0-beta.0...v4.0.0