Enhance model card: Add metadata, paper link, GitHub, and usage example

This PR significantly improves the model card for the SLM-SQL model by:

- Adding the `pipeline_tag: text-generation` to correctly categorize the model for Text-to-SQL tasks on the Hub.
- Adding the `library_name: transformers` to ensure compatibility with the Hugging Face Transformers library and enable the "how to use" button.
- Including relevant `tags` such as `text-to-sql`, `sql`, `qwen2`, and `small-language-model` for better discoverability.
- Providing a link to the paper: [SLM-SQL: An Exploration of Small Language Models for Text-to-SQL](https://huggingface.co/papers/2507.22478).
- Adding a link to the official GitHub repository for code and datasets: [https://github.com/alibaba/SLM-SQL](https://github.com/alibaba/SLM-SQL).
- Including a practical Python code snippet demonstrating how to use the model for Text-to-SQL inference.
- Removing the extraneous "File information" section.

README.md

@@ -1,3 +1,71 @@
----
-license: apache-2.0
----
+---
+license: apache-2.0
+pipeline_tag: text-generation
+library_name: transformers
+tags:
+- text-to-sql
+- sql
+- qwen2
+- small-language-model
+---
+
+# SLM-SQL: An Exploration of Small Language Models for Text-to-SQL
+
+This repository contains **SLM-SQL**, a small language model (SLM) designed for Text-to-SQL tasks, as presented in the paper [SLM-SQL: An Exploration of Small Language Models for Text-to-SQL](https://huggingface.co/papers/2507.22478).
+
+SLM-SQL aims to bridge the performance gap between large language models and smaller models in SQL generation, offering advantages in inference speed and suitability for edge deployment. It achieves this through innovations in post-training techniques, including supervised fine-tuning and reinforcement learning, applied to a Qwen2 base model. The models were evaluated on the BIRD development set, showing significant improvements in execution accuracy, with the 0.5B model reaching 56.87% execution accuracy (EX) and the 1.5B model achieving 67.08% EX.
+
+Code and datasets are available on the official GitHub repository: [https://github.com/alibaba/SLM-SQL](https://github.com/alibaba/SLM-SQL).
+
+## Usage
+
+You can use the model with the Hugging Face `transformers` library. Below is a basic example demonstrating how to load the model and generate a SQL query from a natural language question.
+
+```python
+from transformers import AutoModelForCausalLM, AutoTokenizer
+import torch
+
+# Replace "your_model_id_here" with the specific model ID you want to use (e.g., SLM-SQL/slm-sql-1.5b)
+model_name = "your_model_id_here" 
+
+tokenizer = AutoTokenizer.from_pretrained(model_name)
+model = AutoModelForCausalLM.from_pretrained(model_name, torch_dtype=torch.bfloat16, device_map="auto")
+
+# Example Text-to-SQL prompt
+question = "List the names of all employees who joined after 2020."
+schema = "CREATE TABLE employees (employee_id INT, name TEXT, join_date DATE);"
+
+# Construct the prompt according to the model's expected format (this may vary)
+# A common format for Text-to-SQL is providing the database schema and the natural language question.
+prompt = f"Given the database schema below, generate a SQL query for the following question:
+
+" \
+         f"Schema: {schema}
+" \
+         f"Question: {question}
+
+" \
+         f"SQL Query:"
+
+inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
+
+# Generate the SQL query
+# Adjust generation parameters like max_new_tokens, temperature, top_p as needed
+outputs = model.generate(
+    **inputs,
+    max_new_tokens=256,  # Set an appropriate length for SQL queries
+    temperature=0.7,
+    top_p=0.9,
+    do_sample=True,
+    eos_token_id=tokenizer.eos_token_id
+)
+
+# Decode the generated output, skipping the input prompt and special tokens
+generated_sql = tokenizer.decode(outputs[0][inputs.input_ids.shape[1]:], skip_special_tokens=True).strip()
+
+print(f"Question: {question}")
+print(f"Generated SQL: {generated_sql}")
+
+# Example output might look like:
+# SELECT name FROM employees WHERE join_date > '2020-12-31';
+```