Ask your data.
Trust the answer.

BoloDB lets you talk to any SQL database in plain English. No SQL knowledge required. Every answer comes with a confidence level, a plain-English explanation, and automatic self-repair.

Documentation

Architecture Overview

Browser (SvelteKit frontend, frontend/src) │ HTTP calls to /api/... ▼ FastAPI backend (backend/app) │ ├── controllers/query.py ── the question→answer pipeline (the heart) ├── llm.py ──────────────── the ONLY file that talks to Google Gemini ├── schema_link.py ──────── picks which tables the AI sees ├── sqlvalidate.py ──────── checks generated SQL against the real schema ├── repair.py ───────────── auto-fixes SQL that fails, with AI feedback ├── database.py ─────────── connects to YOUR database, read-only execution ├── knowledge.py ────────── remembers verified answers + glossary (SQLite) └── config.py ───────────── settings: Gemini key + model (~/.bolodb/)