Deepretrieval: Train search agents with retrieval feedback

Understand the project

Practical overview

Use it when you want research code for retrieval-guided query generation or a documented local workflow for model-based query rewriting.

Researchers studying reinforcement learning for search and information retrieval.
Developers prototyping search agents or locally hosted query-rewriting services.

Train a language model to iteratively generate search queries using retrieval results as feedback.
Experiment with retrieval-based rewards for search tasks.
Host the model and rewrite an input query using the repository’s documented script.

Before you choose

The project is public source code under the MIT license. Its documented query-rewriting workflow hosts a model locally.

The training workflow uses retrieval metrics as rewards rather than labeled query-rewrite pairs.
General setup documents Python 3.9, PyTorch, vLLM, Ray and the project’s verl code.
Sparse or dense retrieval may need additional tools such as Pyserini, FAISS and Java; search-engine retrieval requires an API key.
The repository documents query rewriting through a locally hosted vLLM model and Python script.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Host a model with vLLM and submit a query to Deepretrieval’s query-rewriting script.

A Python development environment with the repository’s documented general dependencies, including vLLM, Ray and the verl code.
A model and local port selected for the vLLM host.

Install the documented general dependencies in the repository’s Python 3.9 Conda environment.
Run the command below, specifying the local port and model as needed.
Documented command
```
sh vllm_host.sh
```

Run the command below.

Documented command

python query_rewrite.py --query "Who built DeepRetrieval in 2025?"

The documented workflow returns an original query and a rewritten query.

Evidence and transparency

Source record details

Source availability: Active
Sources checked: 15 October 2026
Original website title: pat-jj/DeepRetrieval · Official homepage title · retained in its source language