# vanna-ai/vanna

🤖 Chat with your SQL database 📊. Accurate Text-to-SQL Generation via LLMs using Agentic Retrieval 🔄.

23,804 stars · 2,548 forks · Python · MIT

Topics: agent, ai, data-visualization, database, llm, rag, sql, text-to-sql

## Use it

### How to install vanna in Claude Code

1. Clone & open

```bash
git clone https://github.com/vanna-ai/vanna.git
cd vanna
claude
```

2. Let 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 Desktop

1. Clone the repository

```bash
git clone https://github.com/vanna-ai/vanna.git
```

2. Open 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 Cursor

1. Clone & open in Cursor

```bash
git clone https://github.com/vanna-ai/vanna.git
```

2. Index & 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 CLI

1. Clone

```bash
git clone https://github.com/vanna-ai/vanna.git
```

2. Point 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 Windsurf

1. Clone & open

```bash
git clone https://github.com/vanna-ai/vanna.git
```

2. Use Cascade

   Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.

### How to install vanna in Cline

1. Clone the repository

```bash
git clone https://github.com/vanna-ai/vanna.git
```

2. Open 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 Code

1. Clone the repository

```bash
git clone https://github.com/vanna-ai/vanna.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

---

Source: https://mcp-skills-hub.vercel.app/repos/vanna-ai-vanna · MCP Skills Hub · data as of 2026-10-28T12:31:05Z