Skip to content extracts all published IATI XML files from the IATI Registry and stores them in a PostgreSQL database, that you can access using a RESTful API.
Python CSS HTML TSQL JavaScript Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Merge branch 'develop' Sep 22, 2019
.github/ISSUE_TEMPLATE Update issue templates Mar 27, 2019
OIPA Merge branch 'develop' Dec 4, 2019
docs Add files via upload Sep 2, 2019
.coveragerc Move .coveragerc file to the outermost folder, .. Dec 13, 2018
.editorconfig Add EditorConfig support Feb 20, 2018
.gitignore Updated git ignore Mar 13, 2019 Code of conduct Mar 27, 2019
Dockerfile Remove additional unneeded requirement Feb 27, 2019
LICENSE.MD Create LICENSE.MD Jun 10, 2015
README.MD Update README.MD Nov 6, 2019
docker-compose.yml Some small fixes to README / code comments Feb 4, 2019 Use cache when installing requirements.txt Feb 1, 2019
mkdocs.yml update docs Apr 21, 2017
setup.cfg Pass extra configuration option to pytest-django.. Feb 5, 2019



License: AGPLv3 Open issues

OIPA extracts all published IATI XML files from the IATI Registry and makes them available in a normalised PostgreSQL database, that you can access using a RESTful API.

IATI is a global aid transparency standard and it makes information about aid spending easier to access, re-use and understand the underlying data using a unified open standard. You can find more about the IATI XML standard at:


Name Recommended version
Python 3.6.5
PostgreSQL 9.6
Redis 4.0.x
PostGIS See: installing PostGIS
SpaciaLite (for tests) See: installing SpatiaLite
Diskspace 80GB minumum

Quick start

If you have Docker installed and want to be able to use OIPA right away, run:

docker-compose up

this will start a containerised (development) environment using Django's development server. Visit on your local browser. The superuser login credentials are oipa / oipa.

If you don't have Docker:

  1. Go to your OIPA folder.
  2. Run virtualenv <name> -p python3 to create a virtual environment
  3. Run source env/bin/activate to activate the virtual environment
  4. Install required libraries using pip install -r requirements.txt
  5. Create a PostgreSQL database
  6. Set your database credentials in OIPA/.env file as follows:
    • OIPA_DB_NAME= your_database_name
    • OIPA_DB_USER= your_db_user
    • OIPA_DB_PASSWORD= your_db_password
  7. Run database migrations with python migrate
  8. Start the development server: python runserver
  9. In order for the parser to work, you need to start Redis too: redis-server
  10. Create a superuser account: python createsuperuser
  11. Start the process control centre (Supervisor): python supervisor
  12. Open your browser at localhost:8000
  13. Follow instructions for signing-in:
  14. Finally, follow the instructions from here:

Happy Hunting!

For more detailed information, see the install documentation

IATI Query Builder

The IATI Query Builder runs on top the the API application. It will allow users to interact with all the IATI data that is available in the IATI Registry using a form based interface which enables a user to select what IATI fields to extract, select dates and output formats.

More information on how to get the IATI Query Builder up and running can be found in the repository.

Full Documentation

Full documentation (which, at this point, needs an update) on installing, running and using OIPA can be found at

About the project

Can I contribute?

Yes please! We are mainly looking for coders to help on the project. If you are a coder feel free to Fork the repository and send us Pull requests!

How should I contribute?

Python already has clear PEP 8 code style guidelines, so it's difficult to add something to it, but there are certain key points to follow when contributing:

  • PEP 8 code style guidelines should always be followed
  • When making commits, in the first line try to summarize changes (in around 50 characters or less) and in the message body (if needed) try to explain what you did, and, most importantly, why. Try to avoid commit messages like "Moving to Python 3" or "Fixed bugs". Other developers should be able to understand why the change was made!
  • Always try to reference issues ("related to #614", "closes #619" and etc.)
  • Avoid huge code commits where the difference can not even be rendered by browser based web apps (Github for example). Smaller commit make it much easier to understand why the change was made, why (if) it resulted in certain bugs and etc
  • When developing new feature, write at least some basic tests for it. This helps not to break other things in the future
  • If there's a reason to commit code that is commented out (there usually should be none), always leave a "FIXME" or "TODO" comment so it's clear for other developers why this was done
  • When using external dependencies that are not in PyPI (from Github for example), stick to a particular commit (i. e. git+, so if the library is updated, it doesn't break everything
  • In the near future, automatic code quality / testing checks (continuous integration tools) will be implemented to check all these things automatically when pushing / merging new branches. Quality is the key!
  • These rules are to be extended

Running the tests

Pytest-django is used to run tests. This will be installed automatically when the project is set up.

To run tests, from the top level directory of the project, run pytest OIPA/. If you are in the same directory where is, only running pytest will be sufficient. Refer to Pytest-django documentations for details.

Tip: to be able to use debuggers (f. ex. ipdb) with pytest, run it with -s option (to turn off capturing test output).

Testing / code quality settings can be found in the setup.cfg file. Test coverage settings (for pytest-cov plugin) can be found at .coveragerc file.

Who makes use of OIPA?

You can’t perform that action at this time.