refactor example - qwen3_reranker

[reidliu41]

Essential Elements of an Effective PR Description Checklist

• The purpose of the PR, such as "Fix some issue (link existing issues this PR will resolve)".
• The test plan, such as providing test command.
• The test results, such as pasting the results comparison before and after, or e2e results
• (Optional) The necessary documentation update, such as updating supported_models.md and examples for a new model.

Purpose

• Move the to main, make the entrypoint clean and keep the same style with the other examples

Test Plan

Test Result

(Optional) Documentation Update

[gemini-code-assist]

Summary of Changes

Hello @reidliu41, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on refactoring the qwen3_reranker.py example script to improve its overall structure, readability, and consistency with standard Python practices. The changes involve encapsulating model initialization and main execution logic into functions, making the script's entry point cleaner and more maintainable.

Highlights

• Code Structure Refinement: I've refactored the qwen3_reranker.py example script to encapsulate the LLM model initialization within a dedicated get_model() function. This promotes better organization and reusability of the model setup.
• Standard Entry Point Adoption: The main execution logic of the script has been moved into a main() function, and the script now uses the standard if __name__ == "__main__": main() pattern. This improves the script's adherence to common Python best practices and consistency with other examples.
• Output Formatting: I've added separator lines (---) around the printed score output to enhance readability and make the results clearer when the script is executed.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in issue comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request refactors the examples/offline_inference/qwen3_reranker.py script by introducing get_model() and main() functions. This is a positive change that improves the script's structure, making it cleaner and more aligned with common Python practices.

My review focuses on enhancing these new functions by suggesting the addition of docstrings and type hints. These additions would improve code clarity, maintainability, and consistency, which are valuable for example code. My suggestions refer to Python's PEP 257 (Docstring Conventions) and PEP 484 (Type Hints).

Additionally, the PR description checklist is largely unfilled. It would be beneficial for the author to complete it to provide more context about the purpose, testing, and any related documentation updates for this change.

[github-actions]

👋 Hi! Thank you for contributing to the vLLM project.

💬 Join our developer Slack at https://slack.vllm.ai to discuss your PR in #pr-reviews, coordinate on features in #feat- channels, or join special interest groups in #sig- channels.

Just a reminder: PRs would not trigger full CI run by default. Instead, it would only run fastcheck CI which starts running only a small and essential subset of CI tests to quickly catch errors. You can run other CI tests on top of those by going to your fastcheck build on Buildkite UI (linked in the PR checks section) and unblock them. If you do not have permission to unblock, ping simon-mo or khluu to add you in our Buildkite org.

Once the PR is approved and ready to go, your PR reviewer(s) can run CI to test the changes comprehensively before merging.

To run CI, PR reviewers can either: Add ready label to the PR or enable auto-merge.

🚀

[noooop]

Please wait for #19675

More usage will be added, hoping they can be considered during refactoring.

[dengcao]

2025年6月26日 更新说明
·本项目旨在解决Qwen3-Reranker模型无法通过Vllm平台直接部署的问题。

·采用vllm最新的开发版制作了Docker镜像dengcao/vllm-openai : v0.9.2-dev，经测试正常，可放心使用。

·修复了Qwen3-Reranker排序结果可能不准确的问题。

注意：2025年6月26日之前已下载本项目的，请删除对应的docker容器和文件后重新使用此方法部署，即可完美在Vllm上运行Qwen3-Reranker模型。

You can use Vllm to deploy the Qwen3-Reranker large model.There is already a temporary solution:

ModelsCope：
https://www.modelscope.cn/models/dengcao/Qwen3-Reranker-8B
https://www.modelscope.cn/models/dengcao/Qwen3-Reranker-4B
https://www.modelscope.cn/models/dengcao/Qwen3-Reranker-0.6B

GitHub：
https://github.com/dengcao/Qwen3-Reranker-8B
https://github.com/dengcao/Qwen3-Reranker-4B
https://github.com/dengcao/Qwen3-Reranker-0.6B

[noooop]

@reidliu41

More and more issues were found upon merging #19675,

there is no need to wait for it.

Sorry for the delay in merging this pr.

[reidliu41]

@noooop oh..thanks for remind.
@DarkLight1337 could you please look at this?

[dengcao]

You can use Vllm to deploy the Qwen3-Embedding&Qwen3-Reranker large model.There is already a temporary solution:
以下是通过vllm快捷安装Qwen3-Embedding-0.6B/4B/8B，Qwen3-Reranker-0.6B/4B/8B的办法。

Docker 快速部署（一键安装包）：
Docker Compose Quick Installation:

Hugging Face：
https://huggingface.co/dengcao/Qwen3-Embedding-0.6B
https://huggingface.co/dengcao/Qwen3-Embedding-4B
https://huggingface.co/dengcao/Qwen3-Embedding-8B
https://huggingface.co/dengcao/Qwen3-Reranker-0.6B
https://huggingface.co/dengcao/Qwen3-Reranker-4B
https://huggingface.co/dengcao/Qwen3-Reranker-8B

ModelScope：
https://www.modelscope.cn/models/dengcao/Qwen3-Embedding-0.6B
https://www.modelscope.cn/models/dengcao/Qwen3-Embedding-4B
https://www.modelscope.cn/models/dengcao/Qwen3-Embedding-8B
https://www.modelscope.cn/models/dengcao/Qwen3-Reranker-0.6B
https://www.modelscope.cn/models/dengcao/Qwen3-Reranker-4B
https://www.modelscope.cn/models/dengcao/Qwen3-Reranker-8B

GitHub：
https://github.com/dengcao/Qwen3-Reranker-8B
https://github.com/dengcao/Qwen3-Reranker-4B
https://github.com/dengcao/Qwen3-Reranker-0.6B