Physicsmile/WISER

<h1 align="center">[CVPR 2026] WISER: Wider Search, Deeper Thinking, and Adaptive Fusion for Training-Free Zero-Shot Composed Image Retrieval</h1>

<p align="center"> If you find this project useful, please give us a star 🌟. </p> <p align="center"> <a href="https://arxiv.org/abs/2602.23029"> <img src="https://img.shields.io/badge/arXiv-2602.23029-b31b1b?logo=arxiv&logoColor=white"> </a> </p>

🔥 News

• —[x] [2026/2/23] Our paper has been accepted to CVPR 2026!
• —[x] [2026/2/27] We release our paper in the arxiv.
• —[x] [2026/2/27] We release the code.

🔎 Overview

[image]

Overview of the proposed WISER framework. (1) Wider Search. We leverage an editor to produce text and image queries for dual-path retrieval, aggregating the top-K results into a unified candidate pool. (2) Adaptive Fusion. We employ a verifier to assess the candidates with confidence scores, applying a multi-level fusion strategy for high-confidence results and triggering refinement for low-confidence ones. (3) Deeper Thinking. For uncertain retrievals, we leverage a refiner to analyze unmet modifications and then feed targeted suggestions back to the editor, iterating until a predefined limit is reached.

⚡️ Getting Started

Requirements

conda create -n wiser python=3.10
conda activate wiser
pip install -r requirements.txt

Data Preparing

Option 1: Download from Hugging Face (Recommended)

We provide the complete datasets (FashionIQ and CIRR) on Hugging Face for easy access:

🤗 [Download WISER Dataset from Hugging Face](https://huggingface.co/datasets/Physicsmile/WISER)

# Install huggingface_hub
pip install huggingface_hub

# Download the dataset
huggingface-cli download Physicsmile/WISER --repo-type dataset --local-dir ./WISER_data

Or using Python:

from huggingface_hub import snapshot_download

snapshot_download(
    repo_id="Physicsmile/WISER",
    repo_type="dataset",
    local_dir="./WISER_data"
)

The dataset includes:

• —fashion-iq.7z: FashionIQ dataset (978MB)
• —CIRR.zip: CIRR dataset (4.55GB)

Option 2: Manual Download

Follow the dataset preparation from CIReVL. After downloading and organizing the datasets, update paths and parameters in ./config/start_config_circo.json.

How to Run

Here we take CIRCO dataset as an example.

Step1: Prepare Gallery Captions

bash run_step1.sh

Step 2: Inference

bash run_step2.sh

📊 Main Results

WISER significantly outperforms previous methods across multiple benchmarks, achieving relative improvements of 45% on CIRCO (mAP@5) and 57% on CIRR (Recall@1) over existing training-free methods. Notably, it even surpasses many training-dependent methods, highlighting its superiority and generalization under diverse scenarios.

<p align="center"> <img src="./imgs/ResultsCIRCOCIRR.png" alt="图片1" width="45%"> &nbsp;&nbsp;&nbsp;&nbsp; <img src="./imgs/Results_FashionIQ.png" alt="图片2" width="45%"> </p>

📄 Citation

@article{wang2026wiser,
  title={WISER: Wider Search, Deeper Thinking, and Adaptive Fusion for Training-Free Zero-Shot Composed Image Retrieval},
  author={Wang, Tianyue and Qu, Leigang and Yang, Tianyu and Hao, Xiangzhao and Xu, Yifan and Guo, Haiyun and Wang, Jinqiao},
  journal={arXiv preprint arXiv:2602.23029},
  year={2026}
}