vanna
vanna-ai/vanna · Updated
🤖 Chat with your SQL database 📊. Accurate Text-to-SQL Generation via LLMs using Agentic Retrieval 🔄.
vanna-ai/vanna is a Python repository in the AI Agents category with 23,804 stars and 2,548 forks on GitHub, released under the MIT license, last updated 8mo ago.
How to install vanna in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install vanna in Claude CodeAnthropic's agentic CLI
Clone & open
bashgit clone https://github.com/vanna-ai/vanna.git cd vanna claudeLet Claude read it
Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.
How to install vanna in Claude DesktopDesktop app (MCP config)
Clone the repository
bashgit clone https://github.com/vanna-ai/vanna.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install vanna in CursorAI-first code editor
Clone & open in Cursor
bashgit clone https://github.com/vanna-ai/vanna.gitIndex & chat
Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.
How to install vanna in Codex CLIOpenAI coding agent
Clone
bashgit clone https://github.com/vanna-ai/vanna.gitPoint Codex at it
Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.
How to install vanna in WindsurfCodeium's agentic IDE
Clone & open
bashgit clone https://github.com/vanna-ai/vanna.gitUse Cascade
Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.
How to install vanna in ClineVS Code autonomous agent
Clone the repository
bashgit clone https://github.com/vanna-ai/vanna.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install vanna in VS CodeCopilot / MCP support
Clone the repository
bashgit clone https://github.com/vanna-ai/vanna.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
Documentation
Full READMEVanna 2.0: Turn Questions into Data Insights
Natural language → SQL → Answers. Now with enterprise security and user-aware permissions.
https://github.com/user-attachments/assets/476cd421-d0b0-46af-8b29-0f40c73d6d83
What's New in 2.0
🔐 User-Aware at Every Layer — Queries automatically filtered per user permissions
🎨 Modern Web Interface — Beautiful pre-built <vanna-chat> component
⚡ Streaming Responses — Real-time tables, charts, and progress updates
🔒 Enterprise Security — Row-level security, audit logs, rate limiting
🔄 Production-Ready — FastAPI integration, observability, lifecycle hooks
Upgrading from 0.x? See the Migration Guide | What changed?
Get Started
Try it with Sample Data
Excerpt — the full document is on GitHub.
More AI Agents repositories
- AI Agents265k
deepseek-harness
DeepSeek Harness: Everything is a Plugin.
TypeScriptMITdeepseek-ai/deepseek-harness
- AI Agents258k
hermes-agent
The agent that grows with you
PythonMITNousResearch/hermes-agent
- AI Agents197k
firecrawl
Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScriptAGPL-3.0firecrawl/firecrawl
- AI Agents180k
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
JavaScriptMITDietrichGebert/ponytail
- AI Agents149k
langchain
The agent engineering platform.
PythonMITlangchain-ai/langchain
- AI Agents110k
orca
Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScriptMITstablyai/orca
Catalog data refreshed . Something wrong? Report it.