Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Software for the OpenArticleGauge service
Failed to load latest commit information.
deploy add gunicorn config
docs update gsm tech design
openarticlegauge Merge tag '2015-01-21_1757_return_id_client_asked_for' into dev
.gitignore Add size and PDF restrictions to downloads
LICENCE implement new self-configuring plugin approach and make the relevant … unfreeze celery dependencies, let it choose them
t.json rename software from IIOA/iioa (IsItOpenAccess) to OAG/oag (OpenArtic…


OpenArticleGauge (OAG) is a service for determining the licence status of journal publications, providing an end-user interface for looking up lists of identifiers, and an API for inclusion into third-party software systems.



You need to install Redis, and start it as per the Redis documentation


You need to install Elasticsearch, and start it as per the documentation

OpenArticleGauge Application

Configure the application, if necessary:


Non-Python requirements

OpenArticleGauge requires lxml, a Python library which is written in C. You need to install lxml's dependencies. Just make sure you install libxml2 development and header files and libxslt development and header files using your Linux distribution's package manager.

If you are on Windows, try .

Here is an example on a Debian-based system:

sudo apt-get update
sudo apt-get install libxml2-dev libxslt-dev

Installing the application

Then install the project requirements using pip (recommended to also use a virtualenv):

pip install -e .


Start the celery backend

sh bin/

or start the daemon with

sh bin/

if you start the daemon, you can stop it with

sh bin/

Note: you may want to modify the shell scripts with paths to the log files you want it to use

Web Application

Before you start the application you must configure the path to the plugin directory in


Start the web application with:

python openarticlegauge/

Note: You may not get any feedback on the standard output. Check oag.log at the root of the repository (where this readme is).

Invalidating Licences

You may wish to remove from the archive particular licence statements associated with identifiers. For example, if a plugin has been added or updated which changes the way that licences for a given provider are detected, you may wish to remove any previous licence statements applied by that plugin, or only particular licence statements (such as those where a licence was not detected). To do this, use the script.

python --help

Some commonly useful options would be

Remove all unknown licenses:

python -a -u

Remove all unknown licenses from a specific handler

python -h handler_name -v handler_version -u

Remove all licenses of a specific type from a specific handler

python -h handler_name -v handler_version -t license_type
Something went wrong with that request. Please try again.