AI Blog

Wren AI vs DB-GPT vs Vanna vs Dataherald: the generator was never the product

The most-starred open-source text-to-SQL project is read-only — Vanna archived its repo on 29 March 2026 at 23.8k stars — and Dataherald has not taken a commit since July 2024. The two still shipping daily are the two that put a durable, reviewable artefact between the question and the SQL. Frontier models absorbed SQL generation; what they cannot absorb is which of your four definitions of "revenue" this question meant, and that is the layer you own whichever project you pick.

By Agentic AI Wiki 12 min read

The most-starred open-source text-to-SQL project on GitHub is read-only: Vanna archived its repository on 29 March 2026 with 23.8k stars, and Dataherald has not accepted a commit since 11 July 2024. The two that are still shipping — DB-GPT and Wren AI, both with commits this week — are the two that put a durable, reviewable artefact between the natural-language question and the generated SQL. That is not a coincidence. Frontier models absorbed SQL generation; nothing absorbs the question of which of your four definitions of "revenue" a user meant, and that layer is yours to own whichever project you install.

At a glance

Four projects that were the obvious shortlist eighteen months ago, and are no longer the same kind of thing as each other.

ProjectLicenceStatus (9 Sep 2026)What it actually is
Wren AI Apache-2.0 by path (docs CC BY 4.0) Active — 0.14.0 released 8 September A governed GenBI platform built around a versioned semantic layer
DB-GPT MIT Active — commits through 8 September A broad data-agent framework; SQL is one of several things it emits
Vanna MIT Archived 29 Mar 2026, read-only A train-and-retrieve Python library, now a hosted commercial product
Dataherald Apache-2.0 Dormant — last commit 11 Jul 2024 API-first NL-to-SQL orchestration over enterprise schemas
GitHub stars (thousands), coloured by maintenance status Horizontal bars: Vanna 23.8 thousand stars, DB-GPT 19.9 thousand, Wren AI 17.6 thousand, Dataherald 3.6 thousand. Bars are filled by maintenance status rather than rank — DB-GPT and Wren AI are actively maintained with commits in September 2026, while Vanna was archived in March 2026 and Dataherald has not taken a commit since July 2024. The longest bar belongs to the archived project. GitHub stars (thousands) 5 10 15 20 25 Vanna 23.8 Archived 29 Mar 2026 — read-only DB-GPT 19.9 Commits through 8 Sep 2026 Wren AI 17.6 0.14.0 released 8 Sep 2026 Dataherald 3.6 Last commit 11 Jul 2024 Actively maintained Archived or dormant Star counts and dates read 9 September 2026.
Stars measure attention that has already happened. The longest bar here is read-only.

Read that chart the way a maintainer would. Vanna's 23.8k is a true measurement of how badly people wanted a two-line path from a question to a query in 2024 — and it tells you nothing about whether anyone will merge your patch in 2026. Dataherald's 262 forks against 3.6k stars is the signature of a project people bookmarked rather than deployed. If your shortlist came from a star-sorted list, it is two years stale.

What actually happened to the two that stopped

Neither project failed in the way open-source projects usually fail. Vanna was archived deliberately, with a finished 2.0 in the README describing a complete rewrite around user-aware agents, lifecycle hooks, LLM middlewares, conversation storage and observability — and the ongoing product is Vanna Cloud, a paid hosted offering. That is a company deciding the open library was distribution and the managed service is the business. It is a legitimate decision and it is fatal to you if you were treating the repo as infrastructure: the code is MIT and yours to fork, but forks of a 972-commit codebase are a staffing commitment, not a licence question.

Dataherald is the quieter shape. Apache-2.0, four services, an architecture people still cite approvingly in comparison posts — and a main branch whose newest commit is a documentation change from July 2024. Twenty-six months is not a lull; it is the entire lifespan of the tool-calling and structured-output APIs that any current NL-to-SQL system would be built on. Anything you deploy from it, you are maintaining against model APIs it has never seen.

The useful question is not which of them was better engineered. It is what the two survivors have that these two did not.

The generator got commoditised; the meaning did not

Where business meaning is stored in each project Four rows, one per project. Wren AI stores meaning in MDL, a versioned JSON manifest of models, relationships, cubes and metrics held in the repository and reviewed in pull requests. DB-GPT stores it across AWEL flow definitions, retrieved knowledge and agent configuration, which is partly declarative and partly operational. Vanna stores it as an accumulated corpus of question and SQL pairs retrieved at query time, which is data rather than a document. Dataherald stores it as golden SQL examples and schema instructions inside its own services. Only the first is something a data team can diff and approve before it reaches the model. Where business meaning is stored Project The artefact between the question and the SQL Can a reviewer approve it? Wren AI MDL — a JSON manifest of models, columns, relationships, views, cubes and metrics, held in the repository. Authored up front. Version-controlled. Portable. Yes — in a pull request, before anything runs. DB-GPT AWEL flow definitions, retrieved knowledge and agent configuration, spread across a wider data-agent runtime. Partly declarative, partly operational state. Partly — flows can be pinned and reviewed. Vanna An accumulated corpus of DDL, docs and question–SQL pairs, retrieved at query time from a vector store. Cheap to start. Not a document anyone owns. No — you cannot diff a training corpus. Dataherald Golden SQL examples and schema instructions held inside its own services, behind an API-first orchestration layer. Explicit examples, but coupled to the runtime. Partly — the examples are explicit, the wiring is not. The output is the same query. The difference is whether the definition it encodes was ever approved by a person.
Same input, same output. The difference is what sits in the middle and whether you can review it.

In 2023, generating syntactically valid SQL against an unfamiliar schema was hard, and a project that did it well had a product. That capability is now a baseline feature of every frontier model and most open-weight ones; the residual errors are almost never syntax. They are semantic: the query joined the right tables and returned a number that means something other than what was asked for, because orders.total includes cancellations, because "active customer" has a definition that lives in a dbt model nobody exported, because the finance team's revenue excludes intercompany and the sales team's does not.

Wren AI states this as its architecture. Business meaning, approved definitions and proven examples are captured in a Modeling Definition Language manifest — models, columns, relationships, views, cubes, metrics — held in the repository, version-controlled, reviewed. The engine underneath is Rust on Apache DataFusion, and the MDL is a JSON schema, which matters more than it sounds: your semantic layer is a portable document rather than an internal state you would have to reverse-engineer to leave.

Vanna's design was the exact opposite, and deliberately so: no semantic layer, no bundled opinion, a training-and-retrieval loop where you feed it DDL, documentation and question–SQL pairs and it retrieves the relevant ones at query time. That is a genuinely lower-friction start, and it is why it got 23.8k stars. It is also an accumulated corpus rather than a document — you cannot diff it, a reviewer cannot approve it, and when a definition changes you are hunting for the stale pairs that still teach the old one. The knowledge was real, but it was never an artefact anyone owned.

DB-GPT sits between them and answers a wider question. It is a data-agent framework — SQL generation, Python analysis, RAG, report generation, multi-model serving, plus AWEL for orchestrating flows and a separate DB-GPT-Hub line of work on fine-tuning models for Text2SQL. Meaning lives partly in AWEL flow definitions and partly in retrieved knowledge, which is more reviewable than a training corpus and less canonical than a manifest. If you want one runtime that also writes the Python and the report, this is the only one of the four still offering it.

The fine print that actually decides adoption

Feature matrix: semantic layer, breadth, maintenance and exit cost A four-by-four matrix. Rows are Wren AI, DB-GPT, Vanna and Dataherald. Columns are a reviewable semantic layer, breadth beyond SQL generation, maintenance signal in 2026, and how much it costs to leave. Wren AI is strong on the semantic layer, medium on breadth, strong on maintenance and low on exit cost because MDL is portable JSON. DB-GPT is medium on the semantic layer, strong on breadth and maintenance, and medium on exit cost. Vanna is weak on the semantic layer, weak on maintenance as an archived repository, and medium on exit cost because the accumulated corpus does not travel. Dataherald is medium on the semantic layer through golden SQL examples, weak on breadth and maintenance, and high on exit cost. Where each project leans hardest Reviewable semantic layer Breadth beyond SQL Maintenance signal, 2026 Cost of leaving Wren AI MDL, versioned BI-shaped Weekly releases Low: JSON travels DB-GPT Flows + knowledge SQL, Python, RAG Daily commits Medium Vanna None by design SQL only Archived Corpus stays put Dataherald Golden SQL SQL only Dormant since 2024 High: you own it Weak Medium Strong Exit cost is scored inverted: strong means cheap to leave.
The two columns on the right are the ones that get skipped in evaluations and decide the outcome.

Three specifics worth knowing before a licence review, none of which appear in the usual comparison tables:

  • Wren AI's licence is multi-licensed by path, not by repo. core/, sdk/, skills/, examples/ and the root files are Apache-2.0; docs/ is CC BY 4.0. There is also a pre-emptive LICENSE-AGPL-3.0 file in the tree for modules the project says it may add later — no path maps to it today, but a legal reviewer who greps for "AGPL" will find it and stop, so get ahead of that conversation rather than discovering it in week three.
  • The repository consolidation is recent. Canner/wren-engine was merged into Canner/WrenAI under core/ in May 2026 and the old repo frozen. Any tutorial, Docker compose file or issue thread older than that points at a layout that no longer exists.
  • DB-GPT's breadth is also its integration surface. Multi-model serving, RAG, agents, AWEL and fine-tuning in one project means more moving parts to pin, and its recent commit log is exactly what you would expect from that — connector fixes, flow-compatibility fixes, provider additions. That is a healthy signal about maintenance and an honest signal about surface area.

And the point that applies to all four: none of them supplies your semantic layer. Wren AI gives you a good format and a review workflow for one; DB-GPT gives you places to put it; the other two gave you a way to accumulate it implicitly. The authoring is the work, it takes a data team weeks, and it is the only part of this stack that will still be worth something after two more model generations. Teams that skipped it got a demo that answered five questions beautifully and then produced a confidently wrong number for the CFO — which is the failure mode data and analytics agents is organised around.

When to pick which

SituationPick Wren AI if…Pick DB-GPT if…Pick neither if…
Self-serve BI for business users You will author and review MDL as a data-team artefact You need charts, Python and reports from one runtime Nobody owns the metric definitions yet — fix that first
An agent that queries data as one tool among many You want the semantic layer callable over MCP and the rest of the agent elsewhere You want the whole data agent inside one orchestration framework One warehouse, ten known questions — write ten views
Regulated or audited reporting Reviewed, version-controlled definitions are the requirement You can pin flows and treat AWEL as reviewed config The answer must be reproducible byte-for-byte — generate the SQL once and ship it
You already run Vanna 0.x in production Migrating buys you a reviewable layer for the knowledge you accumulated Migrating buys you breadth you did not previously have Vanna Cloud is acceptable — the hosted product is the maintained path

The column that should be doing the most work in your evaluation is the last one. A single warehouse and a stable set of questions is answered by views and a dashboard, at a fraction of the operating cost and with none of the semantic ambiguity. Text-to-SQL earns its complexity when the question space is genuinely open and the schema is genuinely large — and it earns nothing at all until somebody has written down what the columns mean.

FAQ

Is Vanna dead?

The open-source repository is archived and read-only as of 29 March 2026, with 23.8k stars and MIT licensing. The company continues with Vanna Cloud, a paid hosted product, and the README documents a 2.0 rewrite plus migration paths from 0.x. So: the library is finished as a maintained dependency; the product is not.

Should I use Dataherald in 2026?

Only as a reference architecture. The newest commit on main is from 11 July 2024, which predates the tool-calling and structured-output APIs any current implementation would build on. Its Apache-2.0 licence means you may fork it freely; the cost is that you own it.

What is MDL and why does it matter?

Modeling Definition Language is Wren AI's semantic manifest — models, columns, relationships, views, cubes and metrics expressed as a JSON schema and held in version control. It matters because it turns business meaning into a document that can be reviewed in a pull request and carried to another tool, instead of a state accumulated inside a vector store.

Do modern LLMs make text-to-SQL tools unnecessary?

They make the SQL-generation part close to solved and the deployment part no easier. What remains is schema selection at scale, safe read-only execution, verification of the returned number, and the semantic disambiguation that no model can do from the schema alone. Those are what these projects are for now.

Which one has the lowest exit cost?

Wren AI, on the specific grounds that its semantic layer is a portable JSON manifest rather than internal state. Your MDL is still meaningful after you uninstall the tool that read it, which is not true of an accumulated question–SQL training corpus.

Further reading

On this wiki:

Project sources: