Ask your data.
Trust the answer.
BoloDB is a multi-tenant text-to-SQL web application powered by DeepSeek v4 Flash via OpenRouter. Connect any SQL database, ask questions in plain English, and get instant answers with charts, confidence levels, and automatic self-repair. Manage workspaces with role-based access control.
Documentation
What is BoloDB?
The product in plain language — what happens when you connect a database and ask a question.
GuideQuick Start
Get BoloDB running in under 5 minutes with Docker.
Chapter 02Question → Answer
The full pipeline, step by step, with exact code locations for every step.
Chapter 03The AI Layer
How BoloDB uses OpenRouter — models, prompts, API keys, retries, and errors.
Chapter 04Schema Linking
How BoloDB picks which tables the AI sees — making answers cheaper and more accurate.
Chapter 05Safety & Self-Repair
Read-only enforcement, SQL validation, and the automatic repair loop.
Chapter 06Trust & Confidence
How BoloDB learns from your confirmations and computes confidence levels.
Chapter 07File Map
Every file in the repository with a one-line description.
Chapter 08Troubleshooting
"Something is wrong" → what it means → where to look → how to fix it.
Chapter 09Cost Optimisation
Where AI costs come from and every mechanism BoloDB uses to keep them low.
Chapter 10Auth & Workspaces
Multi-tenant RBAC — JWT auth, Google OAuth, roles, permissions, and workspace management.
Chapter 11Dashboards & Charts
ECharts visualizations — bar, line, area, pie, number, and table charts auto-inferred from query results.
Chapter 12Semantic Layer
Custom business metrics, join paths, synonyms, and value mappings to guide AI SQL generation.
ReferenceAPI Reference
All REST endpoints with request/response shapes and code locations.