Software for the OpenArticleGauge service
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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