v2.0.0

dgtlmoon/changedetection.iov2.0.0Nov 19, 2025by zainhoda

AI Summary

A complete architectural rewrite introducing an agentic model framework with enterprise security, a modern web interface, and production-ready architecture.

Key Highlights

  • User-Aware Agent Framework with row-level security and audit logging
  • Modern Web Interface with streaming responses and <vanna-chat> component
  • Production-Ready Architecture with FastAPI/Flask and modular tools
  • Rich Streaming Components including interactive tables and visualizations

Breaking Changes

  • Complete architectural rewrite requiring migration from 0.x

New Features

  • User-aware agent framework with identity flows
  • Modern web interface component
  • Production-ready backend servers
  • Rich streaming components (tables, charts, SQL blocks)
  • Support for multiple databases and LLMs

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)