v2.0.0

kyutai-labs/hibikiv2.0.0Nov 19, 2025by zainhoda

AI Summary

Vanna 2.0.0 is a major architectural rewrite focused on agentic models, featuring enterprise security, row-level permissions, and a modern web interface with streaming capabilities.

Key Highlights

  • User-Aware Agent Framework with identity flows, row-level security, and audit logging
  • Modern Web Interface with streaming responses and framework-agnostic design
  • Production-Ready Architecture including FastAPI/Flask servers and observability tools
  • Rich Streaming Components featuring interactive data tables and Plotly visualizations

Breaking Changes

  • Complete architectural rewrite requires migration from 0.x versions
  • Legacy adapter available but full feature access requires new Agent-based architecture

New Features

  • User-Aware Agent Framework
  • Modern Web Interface (vanna-chat component)
  • Production-Ready Architecture (Modular tool system, lifecycle hooks)
  • Rich Streaming Components (Interactive tables, charts, SQL blocks)
  • Support for multiple LLMs and Databases

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)