Text to SQLMath and reasoning

SQL-R1

A text-to-SQL model trained with reinforcement learning: it works through the schema and the conditions step by step before producing a query.

Developer
IDEA Research, China
First release
May 2025
Latest release
Jun 2025
Sizes
3B – 14B
License
Commercial use allowedApache 2.0
Russian
Not stated
Ready-made builds
GGUF
Running
On your own serverNeeds a GPU
Industries
Finance, Retail and marketplaces, Software development
Deploy on your server Hugging Face GitHub

What it does

  • Database queries for questions with several conditions
  • Reviewing and fixing other people SQL queries
  • An analyst helper inside a BI system

Where it is used

Analytics and BIFinance departmentsRetail

Hardware requirements

LaptopLaptop or regular PC, up to 8 GB of VRAM — smaller versions
fits
1 GPUOne GPU with 16–80 GB — mid-size versions
fits
ClusterServer with several GPUs — flagship versions
no versions

Versions

  1. Обновление карточек
  2. SQL-R1 3B, 7B и 14B

How to run it

On your own serverWeights are downloaded from Hugging Face and served with vLLM (load and API) or llama.cpp (modest hardware). The model then runs in a closed network with no per-request fees.Hugging Face
How much hardware you needCalculate the VRAM for the model size, context length and number of concurrent requests.Open the hardware calculator

I can set this up end to end: pick the model size, deploy it on your server and connect it to your systems. Quantization compresses a model so it takes less video memory and runs on more modest hardware. Answers change slightly, so quality is checked on your own examples.

Frequently asked questions

Can SQL-R1 be used in a commercial project?

Yes. License: Apache 2.0. It allows commercial use, but it is still worth having a lawyer review the license before launch.

What hardware does SQL-R1 need?

At minimum: Laptop or regular PC, up to 8 GB of VRAM — smaller versions. Without a GPU the model is not practical. You can calculate the exact VRAM for your model size and context in the hardware calculator.

Does SQL-R1 support Russian?

The model card does not list languages, so Russian support cannot be promised — it has to be tested on your own examples.

Where can I download SQL-R1 and what does it cost?

The SQL-R1 weights are open and free to download. You only pay for the hardware it runs on and for the setup. Source links are at the bottom of this page.

How I deploy it for clients

  1. SelectionI pick the model size for your task and hardware and test it on your examples.
  2. DeploymentI deploy it on your server or in a closed network and provide an API.
  3. Fine-tuningI fine-tune it on your data (LoRA) or connect a knowledge base — whichever is cheaper for the task.
  4. IntegrationI connect it to your CRM, ERP, bot, website or team chat and set up monitoring.

Similar models

Text to SQLArctic-Text2SQL-R1Snowflake · USACommercial use allowed

A Snowflake model for turning questions into SQL, trained with reinforcement learning by checking query results. The open 7B version is based on Qwen2.5-Coder.

DetailsText to SQLOmniSQLRenmin University of China (RUC) · ChinaCommercial use allowed

Models for turning questions into SQL, trained on millions of synthetic query examples across different databases. Three sizes for different hardware.

DetailsText to SQLXiYanSQL-QwenCoderAlibaba · ChinaCommercial use allowed

Alibaba models for turning questions into SQL, based on Qwen2.5-Coder. They work with different SQL dialects; a small 3B version suits modest hardware.

Details

Source: huggingface.co/MPX0222forHF/SQL-R1-14B. Data checked against the model card on 22 Sep 2026. Have a lawyer review the license before commercial launch.