Project
Project is for business users that want to get data from DB but do not have tech skills.
Core trick
Restricts database access to SELECT and DESCRIBE statements while an LLM translates plain-language questions into queries.
Description
Project is for business users that want to get data from DB but do not have tech skills.
It is always prioritize language explanation versus query data.
Main foundations of the project:
- For non tech users
- Can run only SELECT or DESCRIBE, no destuctive actions allowed
- Saves learnings about each table to be better assistant in the future
- Always uses limit for queries
- One run command
- Saves all data locally
- Helps user with multi-select questions to get to the right answer
README excerpt
<div align="center">
<img src="https://github.com/festoinc/vordbeste/blob/main/logo.png" alt="vorDBeste logo" width="320" />
<h3>Talk to your database and learn with it </h3>
<p>
<em>vorbește</em> (Romanian) — to speak. + <strong>DB</strong>. = Speak to your database with AI.
</p>
<br />
</div>
---
vorDBeste helps **non-technical users** explore and understand their databases using natural language. No SQL knowledge required. No command line. Just talk.
## Features
- 🗣️ **Natural language interface** — ask questions in plain English, get answers from your database
- 🔒 **Read-only by design** — only `SELECT` and `DESCRIBE` queries are ever executed. Write operations are never sent to the database
- 🧠 **Clarify before executing** — the AI confirms its understanding of your intent before running queries, resolving ambiguity through conversation
- 📁 **Auto-documentation** — everything discovered during a session (table structures, business rules, useful queries, insights) is saved to markdown files
- 🌐 **Web UI** — clean browser-based interface, no CLI needed
- 🔑 **Bring your own key** — supports **Anthropic**, **OpenAI**, and **Ollama**
- 💾 **All data stored locally** — nothing is sent anywhere except your prompts to the chosen AI provider
## Install & Run with one command
```bash
npm install -g vordbeste && vordbeste
```
That's it. The server starts on `localhost:3456` and the browser opens automatically.
## Setup
On first launch, you'll be guided thro