Starstruk Logo MarkStarstruk

v2.0.0

KoljaB/RealtimeSTTv2.0.0Nov 19, 2025by zainhoda

AI Summary

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

Key Highlights

  • User-aware Agent Framework with identity flows
  • Modern Web Interface with <vanna-chat> component
  • Production-ready architecture with FastAPI/Flask
  • Rich Streaming Components for tables and charts

Breaking Changes

  • Complete architectural rewrite requires migration from 0.x
  • Breaking changes in legacy adapter usage

New Features

  • User-aware agent framework with row-level security
  • Group-based access control
  • Audit logging for compliance
  • Pre-built vanna-chat component for React, Vue, and HTML
  • Streaming responses via SSE
  • Modular tool system
  • Built-in observability and tracing
  • Interactive data tables and Plotly visualizations
  • LLM agnostic support (OpenAI, Anthropic, Ollama, etc.)

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)