grano is a toolkit for building journalistic social network analysis applications on the web. This package contains support for the Refine Reconciliation and Suggestion API. The API can be used to match entities from grano through the user interface of Google Refine and OpenRefine, and thus assist cleaning raw data.

grano-reconcile requires that you have installed and configured grano. Please refer to grano's documentation for further instructions. Afterwards, install the grano-reconcile package (from PyPI or source) into the same virtual environment.

You will also need to configure the Postgres database to support text matching by installing the fuzzystrmatch extension:

CREATE EXTENSION IF NOT EXISTS fuzzystrmatch;

The plugin will provide the full reconviliation API as specified by the OpenRefine wiki. A service endpoint is provided for each project, with under the following URL pattern:

/api/1/projects/<slug>/_reconcile

Further endpoints (for auto-complete suggestion) are available and referenced from the main endpoint.