v2.0.0

vadimdemedes/inkv2.0.0Nov 19, 2025by zainhoda

AI Summary

A major architectural rewrite of Vanna focused on agentic models, featuring a user-aware agent framework, a modern web interface, and production-ready architecture.

Key Highlights

  • Complete rewrite for better support of agentic models like Claude 4.5 and GPT-5.
  • User-aware Agent Framework with row-level security and audit logging.
  • Modern web interface with a pre-built `<vanna-chat>` component.
  • Rich streaming components including interactive data tables and visualizations.
  • Production-ready architecture with FastAPI/Flask servers and modular tool system.

New Features

  • User-aware Agent Framework
  • Modern Web Interface
  • Production-Ready Architecture
  • Rich Streaming Components
  • Modular tool system
  • LLM agnostic support

Full Release Notes

# 🎉 Vanna 2.0.0 - Complete Rewrite for Agentic Models

Turn Questions into Data Insights — Natural language → SQL → Visualization → Answers, now with enterprise security and user-aware permissions. This version has **much** better support for agentic models (Claude 4.5, GPT-5). 

https://github.com/user-attachments/assets/eaed3767-041a-4c81-9023-f3429a58c607

## 🚀 What's New

### User-Aware Agent Framework

- Identity flows through every layer — User context automatically available in tools, SQL queries, and audit logs
- Row-level security — Queries filtered based on user permissions
- Group-based access control — Fine-grained tool access by user groups
- Audit logging — Track every query per user for compliance

### Modern Web Interface

- Pre-built <vanna-chat> component — Drop into any webpage (React, Vue, or HTML)
- Streaming responses — Real-time tables, charts, and progress updates via SSE
- Framework-agnostic — Works with your existing auth (cookies, JWTs, OAuth)
- Customizable themes — Light/dark modes, responsive design

### Production-Ready Architecture

- FastAPI/Flask servers included — Production backends out of the box
- Modular tool system — Extend with custom Tool classes
- Lifecycle hooks — Quota checking, logging, content filtering
- Observability built-in — Tracing and metrics integration
- LLM agnostic — OpenAI, Anthropic, Ollama, Azure, Gemini, Bedrock, Mistral, and more

### Rich Streaming Components

Instead of plain text responses, get:
- Interactive data tables
- Plotly visualizations
- SQL code blocks (admin-only by default)
- Natural language summaries
- Progress indicators

## 📦 Database & LLM Support

Databases: PostgreSQL, MySQL, Snowflake, BigQuery, Redshift, SQLite, Oracle, SQL Server, DuckDB, ClickHouse, Hive, Presto, and more

LLMs: OpenAI, Anthropic Claude, Google Gemini, Azure OpenAI, Ollama, and others

## 🔄 Migration from 0.x

Vanna 2.0 is a complete architectural rewrite. We provide two migration paths:

1. Quick Migration (Legacy Adapter) — Wrap your existing Vanna 0.x instance and get the new UI immediately
2. Full Migration — Rewrite to the new Agent-based architecture for full feature access

See the https://vanna.ai/docs/migration for additional instructions.

## 📚 Resources

- https://vanna.ai/docs — Complete guides and API reference
- https://vanna.ai/docs/quick-start — Get started in minutes
- https://github.com/vanna-ai/vanna/discussions — Ask questions, share ideas
- Demo Video — See Vanna 2.0 in action (above)