v0.2.0

What's New

Added

• ThinkQE — multi-round query expansion via iterative corpus feedback (Le et al., 2025 · arxiv:2506.09260)
  • Iterative loop: round 0 retrieves with the original query; each subsequent round prompts the LLM with the original query + previous round's passages, appends the generated answering passage, and re-retrieves
  • Strips <think>...</think> reasoning traces — designed for DeepSeek-R1 style models
  • Configurable rounds (num_interaction), expansion accumulation (accumulate), and novelty-based passage filtering (use_passage_filter)
  • Prompt template thinkqe.v1 added to prompt bank

Fixed

• Removed misspelled reqeat_weight fallback key in ThinkQE._get_repeat_weight()
• Renamed test_method_thinkqe.py → test_methods_thinkqe.py for naming consistency

Upgrade

pip install --upgrade querygym

v0.1.6

Added

• A comprehensive table documenting all implemented query reformulation methods (GenQR, GenQR Ensemble, Query2Doc, QA Expand, MuGI, LameR, CSQE, Query2E) with descriptions and paper references.

Fixed

• Changed prompt template reference from "genqr.v1" to "genqr.keywords.v1" in the GENQR reformulation method.

Full Changelog: 0.1.5...0.1.6

v0.1.5

Full Changelog: 0.1.4...0.1.5

v0.1.4

Added

• Docker support with pre-built images on GitHub Container Registry (GHCR)
  • GPU-enabled image (ghcr.io/radinhamidi/querygym:latest)
  • CPU-only image (ghcr.io/radinhamidi/querygym:cpu)
  • Multi-platform support (linux/amd64, linux/arm64 for CPU)
• Docker Compose configuration for easy setup
• Comprehensive Docker documentation and examples
• GitHub Actions workflow for automated Docker image building and publishing
• Example notebooks and scripts in examples/ directory
  • Code snippets for quick reference
  • Docker examples with Jupyter notebooks
  • QueryGym + Pyserini integration examples
• DOCKER_SETUP.md quick reference guide
• Makefile for local Docker development

Changed

• License changed from MIT to Apache License 2.0
• Reorganized examples into three categories: snippets, docker, querygym_pyserini
• Updated to OpenJDK 21 (from 17) in Docker images
• Migrated to Docker Compose V2 syntax (docker compose instead of docker-compose)
• Improved Docker image tagging strategy (separate tags for GPU and CPU)
• Enhanced README with Docker installation options and citation information
• Updated all documentation to use modern Docker Compose commands

Fixed

• Docker build issues with OpenJDK availability in Debian Trixie
• Docker Compose tag conflicts between GPU and CPU images
• Inconsistent command examples across documentation

Full Changelog: 0.1.3...0.1.4

v0.1.3

Full Changelog: 0.1.2...0.1.3

v0.1.2

Full Changelog: 0.1.1...0.1.2

v0.1.1

First Release!
Full Changelog: https://github.com/radinhamidi/queryGym/commits/0.1.1