mrkeyoor.com_
Tue 01 Sept 17:39 UTC
Dataevaluationupdated 26 Aug 2026

SQLBot review

SQLBot's primary README is Chinese, and a shorter English translation is available. It is a self-hosted ChatBI application that turns plain-language questions into SQL, tables, charts, and follow-up analysis against connected business data. RAG, terminology, prompts, and saved SQL examples help it understand a team's database vocabulary.

+27stars / 7d
Verdict

Our SQLBot run installed 241 packages and consumed 5,405 MB, then pytest discovered 0 tests and pip-audit reported 30 known vulnerabilities, so adoption needs a real security and regression budget. Use it when you want a complete, actively maintained ChatBI workspace and can lock down its model, database, and container boundaries. Walk away if white-label licensing, an unprivileged deployment, or a passing upstream test suite is mandatory.

We ran it

Lab card: what happened when we ran SQLBotScreenshot of SQLBot (sqlbot.org)
Install✓ · 321s241 packages · 5405 MB
Build✓ · 11s
Tests✗ · 11s0 passed · 0 failed of 0 (pytest)
Known vulns30(pip-audit)
Repo940 files~87,817 lines of source · 36 MB · 7 CI workflows · tests dir

Answers from our run

Does SQLBot build from source?

Dependencies installed in 321 seconds (241 packages), and the build succeeded in 11 seconds. We cloned commit 59ca097 into a clean Debian container with 3 CPUs and no project-specific setup.

Do SQLBot's tests pass?

Yes: 0 of 0 passed when we ran the project's own test command (pytest). Some failures need services or credentials a bare container does not have.

Does SQLBot have known vulnerabilities in its dependencies?

pip-audit flagged 30 known advisories in the dependency tree at the time of our run.

Who should not use SQLBot?

Companies that require white-label redistribution: the modified GPLv3 license forbids removing or changing SQLBot's logo and copyright information.

What are the alternatives to SQLBot?

Chat2DB, WrenAI, DB-GPT. Our SQLBot run installed 241 packages and consumed 5,405 MB, then pytest discovered 0 tests and pip-audit reported 30 known vulnerabilities, so adoption needs a real security and regression budget.

Setup2/5Docker is direct; our install used 5,405 MB and found no tests
Docs3/5English quick start exists, but production guidance is thin
Community4/56,688 stars and active August 2026 issue work
Maturity3/5v1.10.0 shipped security fixes; one authorization report is open

Who it’s for

Data teams that want a ready-made conversational interface over business databases instead of building a text-to-SQL product.
Chinese-speaking organizations that can work from the primary documentation and community material.
Platform teams that need web, pop-up, or MCP access from tools such as n8n, Dify, MaxKB, or DataEase.
Administrators willing to own model-provider configuration, database permissions, and generated-query review.

Who it’s NOT for

Companies that require white-label redistribution: the modified GPLv3 license forbids removing or changing SQLBot's logo and copyright information.
Security teams that cannot accept an unresolved authorization report: issue 1336 says ordinary workspace members can call two export routes intended for administrators.
Organizations that cannot send sample rows to an external model provider: issue 1291 says v1.10.0 sends the first 3 rows of matching tables and asks for a switch to disable it.
Operators whose container policy forbids privileged workloads: the official Docker quick start uses --privileged=true.
Teams that require a discoverable regression suite before adoption: pytest found 0 tests at the commit we measured.

Setup reality

Our sandbox install at commit 59ca097 succeeded in 321 seconds, adding 241 packages and using 5,405 MB on disk. The build passed in 11 seconds. Tests failed with exit code 5 after 11 seconds because pytest discovered 0 tests; the log ended with no tests ran in 0.06s. Pip-audit reported 30 known vulnerabilities.

The README presents deployment as one Docker command. A useful instance still needs an LLM provider configuration and a connected data source. The published command exposes ports 8000 and 8001, mounts five persistent directories, and gives the initial login as admin with password SQLBot@123456.

The documented container requests privileged mode and bundles PostgreSQL storage into the deployment. The repository itself has no Dockerfile, so the published image is the practical quick-start path rather than a locally documented image build. Version 1.10.0 also shipped several authorization and injection fixes, which makes prompt patching and access review part of operating it.

SQLBot packages ChatBI as a workspace application

SQLBot gives non-specialists a chat box for asking questions of business databases. It uses a language model to produce SQL, returns tables and charts, and supports follow-up analysis. Administrators can add terminology, custom prompts, and known-good SQL examples to teach the system how their organization names metrics and tables. The product also has workspace isolation and data-permission controls, which puts it closer to an internal BI service than a developer library.

The measured repository supports that product scope. commit 59ca097 contained 940 files and about 87,817 lines of source, with the Python project under backend/. The checkout was 36 MB before installation. Web embedding, a pop-up interface, and MCP calls are documented integration paths, with n8n, Dify, MaxKB, and DataEase named as consumers. Teams can place SQLBot in front of analysts or expose its query flow to another automation system.

The official container asks for privileged mode

The English quick start tells operators to run one published Docker image with --privileged=true. That is convenient for a trial and awkward for a locked-down production environment. The command also maps the web and service ports directly to the host, persists application files and PostgreSQL data, and restarts the container unless stopped. Before deployment, an operator needs to decide which ports are reachable, where backups live, and whether the image can run with fewer privileges.

The initial interface is documented at port 8000, with a second mapping on 8001. Five host directories preserve spreadsheets, files, images, logs, and PostgreSQL data. The README publishes admin and SQLBot@123456 as the first login, so changing that credential and restricting network access belong in the first session. The repository has no Dockerfile even though it has 7 CI workflow files, which leaves the ready-made image as the documented installation route.

What happened when we ran it

Our sandbox installed the backend at commit 59ca097 in 321 seconds. It pulled 241 packages and occupied 5,405 MB on disk inside a fresh Debian container with 3 CPUs and 8 GB of RAM. The build then succeeded in 11 seconds. Those numbers make the source build possible on modest compute, but the resulting Python environment is large enough to affect CI cache size, developer machines, and image rebuild time.

The test command failed with exit code 5 after 11 seconds. Pytest reported 0 passed and 0 failed because it collected 0 tests, and the final line was no tests ran in 0.06s. The repository has a tests directory, but the log gives no reason for the empty collection, so we will not invent one. Pip-audit found 30 known vulnerabilities in the installed environment. Each advisory needs package-level triage before this build handles production credentials or database access.

Version 1.10.0 fixed security bugs while one access report stays open

Release v1.10.0, published on July 16, lists fixes for SQL injection, prompt injection, privilege escalation, embedded-app security, row-permission escaping, and cross-workspace enumeration. That is meaningful maintenance in software that generates queries and sits near sensitive data. It is also a reason to keep releases current and test authorization at the API boundary instead of relying only on what the interface hides.

Open issue 1336, filed August 24, reports 2 export endpoints without the workspace-admin check used by their corresponding management pages. The report says an authenticated ordinary member can export training and terminology data from the current workspace. Issue 1291 raises another boundary: v1.10.0 reportedly sends the first 3 sample rows of matching tables to the configured model and lacks a setting to turn that off. Buyers with regulated data should verify both behaviors against the exact release they deploy.

The modified GPLv3 terms rule out white-label forks

SQLBot's license follows GPLv3 with added conditions. Its frontend logo and copyright information cannot be removed or modified, and contributors agree that their code may be used in the producer's commercial services. The README directs companies to a support address for commercial licensing. That may be acceptable for an internal deployment carrying SQLBot's identity. It does not fit a vendor intending to ship the interface under its own brand without a separate agreement.

Maintenance activity is current. GitHub showed 6,688 stars, 73 open issues, and 1 open pull request, and the last push was August 26, 2026. The latest tagged release was v1.10.0 from July 16. A current push and busy issue list point to an active project, while the open authorization report shows why activity cannot substitute for a local security review. The combined GitHub repository count was 74 issues and pull requests.

Choose SQLBot when a managed ChatBI workspace is the requirement

SQLBot makes sense when the desired outcome is a browser application with users, workspaces, permissions, charts, saved terminology, and several integration routes. Chat2DB is a better match for a developer-facing database workbench. WrenAI puts more emphasis on a governed semantic layer, while DB-GPT offers a wider data-agent framework. SQLBot's opinionated package saves product work, but it also brings its container, license, and authorization model with it.

Our 321-second install and successful 11-second build show that the backend can be assembled in a clean container. The 5,405 MB footprint, 0 collected tests, and 30 audit findings set the conditions for a responsible trial: isolate it, patch dependencies, add regression coverage, change the default login, and test every database role. Teams willing to do that work get a feature-filled ChatBI starting point. Teams seeking a small text-to-SQL component should pick a narrower project.

Alternatives

ProjectWhat it isPick it when
Chat2DB gh↗A local-first database client with SQL editing, AI query help, Docker, CLI, and MCP options.pick this instead when developers and DBAs need a database workbench with AI help rather than an end-user ChatBI portal.
WrenAIA text-to-SQL and chart system built around a governed semantic context layer.pick this instead when explicit semantic modeling across warehouses matters more than SQLBot's packaged workspace application.
DB-GPTA broader agent platform for building AI applications around databases and other data sources.pick this instead when you want a framework for several data-agent workflows rather than one focused ChatBI product.

What people are saying

  1. [github-trending] dataease/SQLBot

Sources

  1. SQLBot README
  2. SQLBot English README
  3. SQLBot license
  4. SQLBot v1.10.0 release
  5. Issue 1336: workspace export authorization
  6. Issue 1291: model sample-row setting

More data reviews

turso · TrackersListCollection · dash · getcontact-cli · awesome-zhuiju-free · iggy · the whole board →