Instructions to use krogoldAI/QueryRefiner-0.5B-v0.1-GRPO with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use krogoldAI/QueryRefiner-0.5B-v0.1-GRPO with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="krogoldAI/QueryRefiner-0.5B-v0.1-GRPO") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("krogoldAI/QueryRefiner-0.5B-v0.1-GRPO") model = AutoModelForCausalLM.from_pretrained("krogoldAI/QueryRefiner-0.5B-v0.1-GRPO", device_map="auto") messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use krogoldAI/QueryRefiner-0.5B-v0.1-GRPO with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "krogoldAI/QueryRefiner-0.5B-v0.1-GRPO" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "krogoldAI/QueryRefiner-0.5B-v0.1-GRPO", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/krogoldAI/QueryRefiner-0.5B-v0.1-GRPO
- SGLang
How to use krogoldAI/QueryRefiner-0.5B-v0.1-GRPO with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "krogoldAI/QueryRefiner-0.5B-v0.1-GRPO" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "krogoldAI/QueryRefiner-0.5B-v0.1-GRPO", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "krogoldAI/QueryRefiner-0.5B-v0.1-GRPO" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "krogoldAI/QueryRefiner-0.5B-v0.1-GRPO", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use krogoldAI/QueryRefiner-0.5B-v0.1-GRPO with Docker Model Runner:
docker model run hf.co/krogoldAI/QueryRefiner-0.5B-v0.1-GRPO
Update README.md
Browse files
README.md
CHANGED
|
@@ -146,6 +146,32 @@ The model underwent full fine-tuning (not parameter-efficient methods like LoRA)
|
|
| 146 |
|
| 147 |
The training code can be found [here](Code/Fine-tuning.py).
|
| 148 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 149 |
## Model Capabilities
|
| 150 |
|
| 151 |
The model employs a systematic, ontology-inspired analysis framework that decomposes queries into structured XML representations. This analytical approach (which identifies domains, intents, concepts, relations, and ambiguities) aims to enhance the quality of the rephrased query output. For every query, it provides domain classification and intent detection with confidence scores that sum to `1.0`, properly handling both unambiguous cases (single candidate with confidence `1.0`) and ambiguous cases (multiple candidates with distributed confidence). The model can optionally extract explicit and implicit concepts, identify relations between entities using subject-predicate-object triples, and normalize ambiguous terms when disambiguation would improve retrieval.
|
|
@@ -312,37 +338,6 @@ print(analysis)
|
|
| 312 |
|
| 313 |
To assess the model's ability to produce correctly formatted outputs, we evaluated structural conformance across 1,000 examples from the test split of [krogoldAI/rag-ambiguous-queries](https://huggingface.co/datasets/krogoldAI/rag-ambiguous-queries), comparing QueryRefiner-0.5B-v0.1 against its base model [Qwen2.5-0.5B-Instruct](https://huggingface.co/Qwen/Qwen2.5-0.5B-Instruct). The evaluation measured adherence to the required XML schema, including tag presence, well-formedness, element ordering, and confidence score formatting.
|
| 314 |
|
| 315 |
-
|
| 316 |
-
# Model Card for Model ID
|
| 317 |
-
|
| 318 |
-
<!-- Provide a quick summary of what the model is/does. -->
|
| 319 |
-
|
| 320 |
-
GRPO + SFT on 7.3k data from [krogoldAI/rag-query-analysis](https://huggingface.co/datasets/krogoldAI/rag-query-analysis/viewer) with:
|
| 321 |
-
|
| 322 |
-
```py
|
| 323 |
-
NUM_EPOCHS = 2
|
| 324 |
-
PER_DEVICE_BATCH = 4
|
| 325 |
-
GRADIENT_ACCUMULATION = 4
|
| 326 |
-
LEARNING_RATE = 2e-5
|
| 327 |
-
WEIGHT_DECAY = 0.01
|
| 328 |
-
WARMUP_STEPS = 100
|
| 329 |
-
```
|
| 330 |
-
|
| 331 |
-
(--> Breadth)
|
| 332 |
-
|
| 333 |
-
Second SFT on ~3k examples with:
|
| 334 |
-
|
| 335 |
-
```py
|
| 336 |
-
NUM_EPOCHS = 3
|
| 337 |
-
PER_DEVICE_BATCH = 4
|
| 338 |
-
GRADIENT_ACCUMULATION = 4
|
| 339 |
-
LEARNING_RATE = 2e-5
|
| 340 |
-
WEIGHT_DECAY = 0.01
|
| 341 |
-
WARMUP_STEPS = 50
|
| 342 |
-
```
|
| 343 |
-
|
| 344 |
-
(--> Depth)
|
| 345 |
-
|
| 346 |
#### Table 1 - Structural validity metrics (% of outputs meeting each requirement)
|
| 347 |
|
| 348 |
|Metric|Qwen2.5-0.5B-Instruct|QueryRefiner-0.5B-v0.1-SFT|QueryRefiner-0.5B-v0.1-GRPO|
|
|
|
|
| 146 |
|
| 147 |
The training code can be found [here](Code/Fine-tuning.py).
|
| 148 |
|
| 149 |
+
GRPO + SFT on 7.3k data from [krogoldAI/rag-query-analysis](https://huggingface.co/datasets/krogoldAI/rag-query-analysis/viewer) with:
|
| 150 |
+
|
| 151 |
+
```py
|
| 152 |
+
NUM_EPOCHS = 2
|
| 153 |
+
PER_DEVICE_BATCH = 4
|
| 154 |
+
GRADIENT_ACCUMULATION = 4
|
| 155 |
+
LEARNING_RATE = 2e-5
|
| 156 |
+
WEIGHT_DECAY = 0.01
|
| 157 |
+
WARMUP_STEPS = 100
|
| 158 |
+
```
|
| 159 |
+
|
| 160 |
+
(--> Breadth)
|
| 161 |
+
|
| 162 |
+
Second SFT on ~3k examples with:
|
| 163 |
+
|
| 164 |
+
```py
|
| 165 |
+
NUM_EPOCHS = 3
|
| 166 |
+
PER_DEVICE_BATCH = 4
|
| 167 |
+
GRADIENT_ACCUMULATION = 4
|
| 168 |
+
LEARNING_RATE = 2e-5
|
| 169 |
+
WEIGHT_DECAY = 0.01
|
| 170 |
+
WARMUP_STEPS = 50
|
| 171 |
+
```
|
| 172 |
+
|
| 173 |
+
(--> Depth)
|
| 174 |
+
|
| 175 |
## Model Capabilities
|
| 176 |
|
| 177 |
The model employs a systematic, ontology-inspired analysis framework that decomposes queries into structured XML representations. This analytical approach (which identifies domains, intents, concepts, relations, and ambiguities) aims to enhance the quality of the rephrased query output. For every query, it provides domain classification and intent detection with confidence scores that sum to `1.0`, properly handling both unambiguous cases (single candidate with confidence `1.0`) and ambiguous cases (multiple candidates with distributed confidence). The model can optionally extract explicit and implicit concepts, identify relations between entities using subject-predicate-object triples, and normalize ambiguous terms when disambiguation would improve retrieval.
|
|
|
|
| 338 |
|
| 339 |
To assess the model's ability to produce correctly formatted outputs, we evaluated structural conformance across 1,000 examples from the test split of [krogoldAI/rag-ambiguous-queries](https://huggingface.co/datasets/krogoldAI/rag-ambiguous-queries), comparing QueryRefiner-0.5B-v0.1 against its base model [Qwen2.5-0.5B-Instruct](https://huggingface.co/Qwen/Qwen2.5-0.5B-Instruct). The evaluation measured adherence to the required XML schema, including tag presence, well-formedness, element ordering, and confidence score formatting.
|
| 340 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 341 |
#### Table 1 - Structural validity metrics (% of outputs meeting each requirement)
|
| 342 |
|
| 343 |
|Metric|Qwen2.5-0.5B-Instruct|QueryRefiner-0.5B-v0.1-SFT|QueryRefiner-0.5B-v0.1-GRPO|
|