Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Continuous Integration

Builds are handled by Travis CI at

master branch (stable releases) Build Status

develop branch (development) Build Status

Chat with us on Gitter!

Latest Data File

The current Postgres database dump is openods_015_sep17_001.dump and can be downloaded from:

The Code



  • Python 3.6+
  • Virtualenv pip install -g virtualenv
  • PostgreSQL ( is simple for development on OSX)


Getting Started

  1. Clone this repository to your local machine

    $ git clone
  2. In the terminal, navigate to the newly cloned repository on your machine

    $ cd ~/Source/open-ods
  3. Create a Python3 Virtualenv

    $ virtualenv -p python3 openods

    Check that python3 is installed properly by running python and checking the version number displayed.

    $ python --version
    Python 3.6.1
  4. Activate the virtualenv

    $ source env/bin/activate
  5. Install libmemcached (for caching using flask-heroku-cacheify)

    On OSX, you can use homebrew to easily install libMemcached

    $ brew install libmemcached

    On CentOS, you can use yum to install libmemcached and zlib

    sudo yum install zlib-devel libmemcached-devel

    If you're using another OS you will have to refer to appropriate instructions for your OS.

  6. Install the project dependencies from the requirements-dev.txt file.

    $ pip install -r requirements-dev.txt

    Note: requirements-dev.txt contains a list of all dependencies including those needed during the development process.

    When deploying to production, you would use the requirements.txt file to install dependencies.

  7. Now follow this guide to import the OpenODS data into your local database instance:

    Importing OpenODS data to your PostgreSQL instance

  8. Assuming all steps have completed successfully, you should be able to test that you can run OpenODS using the built-in Flask development server.

    From the project root, run:

    $ python
    Database URL: postgresql://openods:openods@localhost:5432/openods
    Cache Timeout: 30
    APP Hostname: http://localhost:5000/api
    API Path: /api
    DEBUG: False
    * Running on (Press CTRL+C to quit)

Using Docker

To get an instance of OpenODS running in Docker, follow this README

Source Data Attribution

Organisation Data Service, Health and Social Care Information Centre, licenced under the Open Government Licence v2.0 - Open Government Licence

More information on the Organisation Data Service can be found on the HSCIC website


This project is licensed under GNU GPL v3.

Copyright (c) 2017 Matt Stibbs and Tony Yates