Nomenklatura de-duplicates and integrates different names for entities - people, organisations or public bodies - to help you clean up messy data and to find links between different datasets.
The service will create references for all entities mentioned in a source dataset. It then helps you to define which of these entities are duplicates and what the canonical name for a given entity should be. This information is available in data cleaning tools like OpenRefine or in custom data processing scripts, so that you can automatically apply existing mappings in the future.
The focus of nomenklatura is on data integration, it does not provide further functionality with regards to the people and organisations that it helps to keep track of.
This is a fork of pudo/nomenklatura. OpenNames.org, a public hosted instance of nomenklatura got recently shut down because the project has taken a different direction. This fork tries to maintain a compatible version of nomenklatura thats usable as a plug-in replacement.
A docker image is available as unicef/nomenklatura
in the docker index.
- postgres
- virtualenvwrapper
pipenv install
npm install
psql -c 'CREATE DATABASE nomenklatura;' -U postgres
python manage.py createdb
python manage.py runserver
If you want to deploy your own Nomenklatura instance, use the unicef/nomenklatura
docker container:
docker-compose up
Required environment variables:
DATABASE_URL: postgres://username:password@databasehost/nomenklatura
SECRET_KEY: something_unique_and_secret_here # used for the session cookie
Register a new OAuth application on github with the following parameters:
- Homepage URL: URL to your nomenklatura instance
- Authorization Callback URL: https://your.nomenklatura.example/api/2/sessions/callback
Then add these environment variables:
GITHUB_CLIENT_ID: your_client_id_from_github
GITHUB_CLIENT_SECRET: your_client_secret_from_github
nomenklatura is developed with generous support by Knight-Mozilla OpenNews and the Open Knowledge Foundation Labs. The codebase is licensed under the terms of an MIT license (see LICENSE.md).
We're keen for any contributions, bug fixes and feature suggestions, please use the GitHub issue tracker for this repository.