Skip to content
Aotearoa New Zealand legislation as code
Branch: master
Clone or download
Latest commit d4ef429 May 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Move lint to own job May 3, 2019
.github mahi tuatahi Apr 11, 2018
openfisca_aotearoa Added minimum wage May 14, 2019
.gitignore Improve gitignore readability May 17, 2017
.python-version update readme to include pyenv Feb 13, 2019
.yamllint Accident Compensation Act - Loss of Earnings and Loss of Potential Ea… May 14, 2019 Create May 14, 2019
LICENSE.AGPL.txt Add License May 16, 2017 Package all files in pip May 17, 2017
Makefile Moved linter to seperate circleci step Aug 8, 2018
Procfile Added changelog, removed duplicate residence variable, rolled major v… Jun 15, 2018 Update Mar 29, 2019 correct install command for docker Apr 3, 2019 Fix typo in instructions May 17, 2019
app.json App.json allows PR review to be deployed and adding deploy button to … Aug 7, 2018
runtime.txt Upgrade to python 3.7.2 Mar 11, 2019
setup.cfg Accident Compensation Act - Loss of Earnings and Loss of Potential Ea… May 14, 2019

OpenFisca Aotearoa


Writing the Legislation

This is an experiment. We've coded large swathes of New Zealand's legislation, regulation, and some government policy into rules that run in the Open Fisca calculation engine. We've released all the code here, for anyone to use.

From late January 2018, the Service Innovation Lab (LabPlus) facilitated a cross-agency and multidisciplinary team in a 3 week Discovery Sprint exploring the challenges and opportunities of developing human and machine consumable legislation for effective and efficient service delivery.

Please also read the wiki as a way of introduction.

The Lab Team's server

An instance of Open Fisca is running at

and an app called "Rapu Ture" is available to explore which variables exist

Install Instructions for Users and Contributors

This package requires Python 3 and pip .

Installing this Country Package (Aotearoa New Zealand)

Supported platforms:

  • GNU/Linux distributions (in particular Debian and Ubuntu);
  • Mac OS X;
  • Microsoft Windows (we recommend using ConEmu instead of the default console).

Other OS should work if they can execute Python and NumPy.

Pick option (A) or (B)

A. Minimal Installation - for users running the rules

Follow this installation if you wish to:

  • run calculations on a large population;
  • run your own instance of OpenFisca-Aotearoa
  • run your own instance of the OpenFisca-Aotearoa rules package, as an OpenFisca Web API.
  • not modify the rules

There are 3 documented ways to do this - Pick your tech:

B. Advanced Installation - for devs, modifying the rules and code

Follow this tutorial if you wish to change the OpenFisca-Aotearoa rules or contribute to the source code.

Read the Setup Aotearoa Open Fisca in pyenv instructions to manage python runtimes and eggs

pyenv is simular to rbenv/rvm (for ruby) and nvm (for nodejs).

Next Steps

You can’t perform that action at this time.