Skip to content

Repository files navigation

ResearchQA

🌐 Website | 📄 Paper | 🗂️ Dataset

ResearchQA is designed to evaluate scholarly question answering across 75 fields, using questions and rubrics mined from survey papers. The dataset consists of 3,750 questions in the test set, 703 in the validation set, and a total of 21,414 questions. Both the questions and rubrics have been validated by 31 Ph.D. level annotators across 8 fields.

Introduction

This repository contains the necessary scripts to download the ResearchQA dataset and compute rubric coverage scores.

  • download_researchqa.py: Downloads the ResearchQA dataset from the Hugging Face Hub. You can specify different data splits.
  • compute_coverage.py: Computes rubric coverage scores for a given set of responses to the ResearchQA questions. This script uses gpt-4.1-mini to evaluate how well a response covers the rubric items associated with a question.

Installation

# Clone the repository
git clone https://github.com/realliyifei/ResearchQA.git
cd ResearchQA
# Create a new conda environment and install dependencies
conda create -n researchqa python=3.10
conda activate researchqa
pip install -r requirements.txt

Configuration

# OpenAI API Key
export OPENAI_API_KEY="your-openai-api-key"
# Hugging Face Hub Token (if download automatically)
export HUGGING_FACE_HUB_TOKEN="your-hugging-face-token"

Usage

Download the Dataset

You can download different splits of the ResearchQA dataset.

python download_researchqa.py --split test.json

The available splits are test.json, valid.json, and full.json.

Compute Rubric Coverage

To compute the coverage score, you need the dataset file (e.g., test.json) and a JSON file containing the model's responses.

The response file should be a map where keys are item IDs and values are objects containing an "answer" field. Example responses.json:

{
  "id_1": {
    "answer": "This is the model's answer to question 1."
  },
  "id_2": {
    "answer": "This is the model's answer to question 2."
  }
}

Compute Elo Rankings

The pairwise comparison can be found here, and the leaderboard notebook refers to here.

Leaderboar Submission

You are welcome to submit your system ouputs and scores to the leaderboard! The instruction is here.

Resource

You can download the 18 systems outputs and their rubric coverage scores to check the performances and run your own Elo rankings.

Also, the pairwise data for human evaluation is in this folder.

Citation

@article{yifei2025researchqa,
  title={Research{QA}: Evaluating Scholarly Question Answering at Scale Across 75 Fields with Survey-Mined Questions and Rubrics},
  author={Yifei, Li S. and Chang, Allen and Malaviya, Chaitanya and Yatskar, Mark},
  journal={Transactions of the Association for Computational Linguistics},
  year={2026},
  note={To appear},
}

About

No description, website, or topics provided.

Resources

Stars

10 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages