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.
| Project | Licence | Status (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 |
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
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
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-emptiveLICENSE-AGPL-3.0file 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-enginewas merged intoCanner/WrenAIundercore/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
| Situation | Pick 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:
- Data & Analytics Agents — schema grounding, read-only execution, and scoring abstention above confident error.
- Query Understanding for RAG — the disambiguation step that decides whether the retrieval was ever going to work.
- Structured Outputs — why constrained generation moved the hard part away from syntax.
- Tool Design Principles — what a good "query the warehouse" tool looks like from the model's side.
- Hallucination & Grounding — the confidently wrong number, and why grounding makes it cheap to catch.