Skip to content
Information Retrieval Relevance Judging System
HTML Python JavaScript Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


Relevation: A raising or lifting up. - Wiktionary

Relevation is a system for performing relevance judgements for Information Retrieval system evaluation. Documents and queries can be uploaded to the system via the web interface. Judges can browse the uploaded documents and queries and provide their relevance assessments.

Who is Relevation! aimed at?

Relevation! is aimed at anyone wishing to collection relevance assessment for information retrieval evaluation evaluation.

If you do use Relevation! we would appreciated it if you cited us:

B. Koopman and G. Zuccon. Relevation!: An open source system for information retrieval relevance assessment. In Proceedings of the 37th annual international ACM SIGIR conference on research and development in information retrieval, Gold Coast, Australia, July 2014.


Relevation! is build using Python's (version 2.7) Django (version 1.6) web framework and Twitter's Bootstrap.

Setup Steps

  1. Checkout relevation from github with: git clone
  2. Copy your documents into the relevation/documents folder.
  3. Start Relevation! by running ./ runserver. Relevation! will be running at
  4. Go to Setup page and upload your queries and document pool. (Queries are in the form queryId[tab]queryText; the pool is in standard TREC results format.)

You can also look at a demo that shows how to setup Relevation! from scratch; the demo is available at

Use cases

Relevation has been used in anger for:

Authors and Support

Relevation was designed by Bevan Koopman and Guido Zuccon. Relevation is an open source project still in development.

You can’t perform that action at this time.