Natural Language SQL
Natural Language SQL turns plain-English database questions into SQL, validates and runs the query, then streams results back.
What Natural Language SQL is
Natural Language SQL turns plain-English database questions into SQL, validates and runs the query, then streams results back. It connects to PostgreSQL and MySQL, including multiple databases of the same type at once. Hybrid retrieval uses BM25 and sentence-transformer vectors to choose relevant schema context. Before execution, users can review and edit the generated SQL, while the interface shows progress through query stages. Results can be sorted, paginated at 50 rows per page, downloaded as CSV or JSON, or copied as tab-separated text. SELECT queries receive a default limit, explicit result counts are capped at 1,000 rows, and execution times out after 30 seconds by default. INSERT, UPDATE, and DELETE are allowed by default, with warning banners; the project recommends a read-only database user to block writes. Ollama runs locally by default, keeping questions, schema, and generated SQL on the machine, and the project says it has no telemetry. OpenAI, Gemini, and Groq are optional cloud providers; those providers receive the question, relevant schema portion, and SQL context. The project is free under GPL-3.0. Its recommended Docker setup needs Docker 20.10+ with Compose v2, about 10 GB of disk space, and downloads an approximately 5 GB model on first run.
Good
- Connects to PostgreSQL and MySQL.
- Review and edit SQL before execution.
- Ollama keeps query context on the user's machine.
- Exports results as CSV or JSON.
Watch out
- INSERT, UPDATE, and DELETE are enabled by default.
- Recommended Docker setup needs about 10 GB free disk space.
- First run downloads an approximately 5 GB model.
Who it suits
It suits users who want to ask questions of PostgreSQL or MySQL databases in plain English and inspect SQL before running it. Local Ollama is a fit for those who want questions, schema, and generated SQL to remain on their machine.
Verdict
Natural Language SQL pairs plain-language questions with editable SQL and streamed query progress. Check the default write-query behavior and deployment requirements before setting it up.
Plans and prices
From Natural Language SQL's own pricing page, checked 5 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Natural Language SQL Engine | Free | GPL-3.0 open-source project · local installation |
The facts
Each one read from Natural Language SQL's own pages, with the date it was checked.
What it does
- AI providers
- Ollama runs locally by default, with OpenAI, Gemini, and Groq available as opt-in cloud providers.checked 4 Oct 2026
- Benchmark
- The README reports 52.32% execution accuracy on Spider dev.checked 5 Oct 2026
- Cloud model options
- OpenAI, Google Gemini, and Groq are opt-in providers; using one sends the question, relevant schema portion, and SQL context to that provider.checked 5 Oct 2026
- Cloud privacy
- With an opt-in cloud provider, the question, relevant schema portion, and generated SQL context are sent to that provider; database passwords and query result rows are excluded.checked 4 Oct 2026
- Credential security
- Database passwords and cloud API keys are Fernet-encrypted on disk, redacted from logs, and masked in API responses.checked 5 Oct 2026
- Database integrations
- The app supports connecting to PostgreSQL and MySQL databases, including multiple databases at once.checked 5 Oct 2026
- Database support
- It connects to PostgreSQL and MySQL and can query multiple same-type databases in parallel.checked 4 Oct 2026
- Deployment
- The recommended Docker setup requires Docker 20.10 or later with Compose v2 and about 10 GB of free disk space.checked 5 Oct 2026
- Deployment requirements
- The recommended Docker setup requires Docker 20.10+ with Compose v2 and about 10 GB of free disk space; the first run downloads an approximately 5 GB model.checked 4 Oct 2026
- License
- The repository states that the project is licensed under GPL-3.0.checked 5 Oct 2026
- Local AI
- Ollama runs locally by default, and the project says questions, database schema, and generated SQL stay on the user's machine with this provider.checked 5 Oct 2026
- Local privacy
- With the default Ollama provider, questions, schema, and generated SQL stay on the user's machine, and the app says it has no telemetry.checked 4 Oct 2026
- Privacy
- The project says it collects no telemetry; query results, schema metadata, and query history are held in memory for the session and are not written to disk by the application.checked 5 Oct 2026
- Purpose
- The engine turns plain-English database questions into SQL, validates and executes the query, and streams back results.checked 5 Oct 2026
- Query limits
- SELECT queries receive a default LIMIT of 100, results are capped at 1,000 rows by default, and each query has a 30-second timeout by default.checked 5 Oct 2026
- Query workflow
- Users can inspect and edit generated SQL before execution, and receive live progress across connection, schema, AI, validation, and execution stages.checked 5 Oct 2026
- Results
- Results can be sorted and paginated, exported as CSV or JSON, or copied as tab-separated text.checked 5 Oct 2026
- Schema retrieval
- Hybrid retrieval uses BM25 and sentence-transformer vectors to select relevant schema context for a question.checked 5 Oct 2026
- Write queries
- INSERT, UPDATE, and DELETE are supported by default, with warning banners; the project recommends a read-only database user to block writes.checked 5 Oct 2026
The full review of Natural Language SQL
Overview
Natural Language SQL is a self-hosted engine for turning database questions written in everyday language into executable SQL. It is best suited to developers and teams who want local AI and the chance to inspect queries before they run. Its privacy-conscious defaults and open-source license are appealing, but a large local model and write-enabled queries call for careful setup.
Key features
Hybrid schema retrieval combines BM25 search with sentence-transformer vectors to find relevant database context for each question. That can help users ask about an existing schema without assembling context by hand, while the reported 52.32% execution accuracy on Spider dev underscores why generated SQL should not be treated as infallible.
Users can edit generated SQL before execution, and streamed progress makes the query workflow visible. Explanations, sorting, 50-row pagination, CSV and JSON downloads, and tab-separated copying support inspection and handoff. SELECT queries get a default LIMIT; explicit result counts are capped at 1,000 rows, and execution times out after 30 seconds by default.
The safeguards are not a substitute for access control: INSERT, UPDATE, and DELETE are allowed by default, with warning banners. The project recommends connecting with a read-only database user if writes must be blocked.
Ollama runs locally by default, and the project says questions, schema, and generated SQL stay on the user's machine with that provider. There is no telemetry; schema metadata, query results, and query history remain in session memory rather than being written to disk by the application. Choosing OpenAI, Gemini, or Groq sends the question, relevant schema portion, and SQL context to that provider, but not database passwords or result rows. Database passwords and cloud API keys are Fernet-encrypted at rest, redacted from logs, and masked in API responses.
Pricing
The Natural Language SQL Engine costs nothing. It is a GPL-3.0 open-source project for local installation, with no paid tier or usage quota described. That makes it a fit for users willing to run and maintain the software themselves; those seeking a managed hosted plan should consider alternatives.
Platforms
Natural Language SQL is offered for API, Linux, macOS, self-hosted, and web use. Its recommended Docker deployment needs Docker 20.10 or later with Compose v2 and about 10 GB of free disk space; the first run downloads an approximately 5 GB model. That footprint is a meaningful cost in storage and setup effort, especially on smaller machines.
Who it's for
This is a sensible choice for developers who work with PostgreSQL or MySQL, want to query multiple databases of the same type in parallel, and can manage a local deployment. Local Ollama is particularly suited to users who prefer database context to stay on their machine. It is less appropriate when writes must be prevented without a read-only account, or when the deployment requirements are impractical.
Pros and cons
- Pros: Local Ollama keeps questions, schema, and SQL on the user's machine, and the project says it collects no telemetry.
- Pros: Editable SQL, explanations, streamed progress, and practical export options support review rather than blind execution.
- Pros: Free, open-source local installation connects to PostgreSQL and MySQL, including multiple same-type databases in parallel.
- Cons: Docker deployment calls for about 10 GB of free disk space, with an approximately 5 GB model download on first run.
- Cons: Write queries are enabled by default, so safe use against protected data depends on database permissions.
- Cons: The reported Spider dev execution accuracy is 52.32%, making human review important.
Alternatives
AI SQL Generators is the broader category to browse when comparing tools.
Choose Outerbase AI if a freemium option with a free tier capped at five users, one base, and 10 EZQL queries a month suits better than a local open-source engine.
NatureQuery offers a free tier with 50 queries per month, one database connection, exports, and 30-day query history.
SQL Mocker has a free Explore tier with 50 AI queries total, one user, and five saved projects.
Wren AI is an option for individual developers seeking an open-source context engine through CLI and MCP without a UI.
QueryPlane offers a free tier for up to three apps, one database connection, and 50 AI prompts per month.
mnemiq is another free, open-source engine designed to run in your own environment.
Text2SQL.ai is a paid option with a free trial and API access listed for its Pro Plan.
Vanna AI may suit readers looking for a freemium product with a paid Explorer plan that includes 20 questions per day, API access, and same-day email support.
Verdict
Choose Natural Language SQL if you can self-host, want local AI, and value the ability to inspect and edit SQL before it runs. Its strongest case is keeping database context on your machine without a software charge; look elsewhere if you need managed deployment or cannot rely on a read-only database account to prevent writes.
Getting started
- Open the project's GitHub repository.
- Prepare Docker 20.10 or later with Compose v2 for the recommended setup.
- Ensure about 10 GB of free disk space for that setup.
- Run the recommended Docker setup and allow the first run to download the approximately 5 GB model.
- Connect a PostgreSQL or MySQL database and use Ollama locally or select an optional cloud provider.
Limits worth knowing
SELECT queries receive a default LIMIT, explicit result counts are capped at 1,000 rows by default, and queries time out after 30 seconds by default. The recommended Docker setup requires about 10 GB of free disk space and downloads an approximately 5 GB model on first run.
Questions
Does Natural Language SQL cost anything?
The project is free and open source under the GPL-3.0 license.
Which databases can it query?
It connects to PostgreSQL and MySQL, including multiple databases of the same type at once.
Which AI providers are available?
Ollama runs locally by default. OpenAI, Google Gemini, and Groq are available as optional cloud providers.
What information is sent to a cloud provider?
The question, relevant portion of the schema, and generated SQL context are sent. Database passwords and query result rows are excluded.
What are the recommended Docker requirements?
Docker 20.10 or later with Compose v2 and about 10 GB of free disk space are required. The first run downloads an approximately 5 GB model.
Can it run write queries?
INSERT, UPDATE, and DELETE are allowed by default and show warning banners. The project recommends a read-only database user to block writes.
Alternatives to Natural Language SQL
- 1

Outerbase AI
Free planOpen sourceWebAPILinuxmacOS8.2From $9 a month - 2

Wren AI
Free planWebAPISelf-hosted6.9From $179 a month - 3

Savvina AI
Free planWebAPISelf-hosted6.7From €39 a month - 4

NatureQuery
Free planWebAPI6.6From $20 a month - 5
SQL Mocker
Free planWeb6.6From $10 a month - 6
SQLer
Free planWebAPI6.6From $199 a month
