Instructions to use casyssong/RefReward-SR with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use casyssong/RefReward-SR with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="casyssong/RefReward-SR")# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("casyssong/RefReward-SR", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use casyssong/RefReward-SR with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "casyssong/RefReward-SR" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "casyssong/RefReward-SR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/casyssong/RefReward-SR
- SGLang
How to use casyssong/RefReward-SR 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 "casyssong/RefReward-SR" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "casyssong/RefReward-SR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'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 "casyssong/RefReward-SR" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "casyssong/RefReward-SR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use casyssong/RefReward-SR with Docker Model Runner:
docker model run hf.co/casyssong/RefReward-SR
library_name: transformers
base_model:
- Qwen/Qwen3-VL-8B-Instruct
tags:
- reward-model
- super-resolution
- qwen3-vl
- grpo
- academic-research
pipeline_tag: image-text-to-text
RefReward-SR
LR-Conditioned Reward Modeling for Preference-Aligned Super-Resolution
Model Card
This repository contains the released RefReward-SR checkpoint only. The SR-GRPO-LoRA weights are released in a separate repository.
RefReward-SR is an LR-conditioned reward model for super-resolution. Given a low-resolution (LR) reference image and a super-resolved (HR) image, it assesses semantic consistency and perceptual plausibility using the LR image as a semantic anchor. The model supports direct scoring (fast) and reasoning-aware scoring (think).
Checkpoint
| Item | Description | Size |
|---|---|---|
RefReward-SR (checkpoint-1200) |
Qwen3-VL-8B LR-conditioned reward model fine-tuned with GRPO | 17G |
Base Weight and Training Dataset
| Type | Resource | Role |
|---|---|---|
| Base weight | Qwen3-VL-8B-Instruct | Initialization for GRPO fine-tuning |
| Training dataset | RefSR-18K | LR-conditioned human preference data used for reward-model training |
Upstream License Information
This model card does not declare a new license for the released checkpoint. The relevant upstream terms are:
| Resource | Upstream license |
|---|---|
| Qwen3-VL-8B-Instruct | Apache License 2.0 |
| RefSR-18K | See the RefSR-18K dataset card |
Users are responsible for reviewing and complying with the applicable upstream terms.
Citation
@article{song2026refreward,
title={RefReward-SR: LR-Conditioned Reward Modeling for Preference-Aligned Super-Resolution},
author={Song, Yushuai and Quan, Weize and Wang, Weining and Sun, Jiahui and Liu, Jing and Li, Meng and Yu, Pengbin and Chen, Zhentao and Shen, Wei and Yuan, Lunxi and Yan, Dong-ming},
journal={arXiv preprint arXiv:2603.24198},
year={2026}
}