Taxman provides a set of tools for computing Income Tax and National Insurance contributions for the UK tax system.
It currently supports calculating Income Tax and National Insurance contributions (for both employer and employee), and deducting these to return the net income.
At the moment, it can only calculate these for the tax year 2018-19, but support for configuring it to calculate for any tax year will be added soon.
The current version of Taxman has been tested to work on Python 3.6. Although it may work on other versions, it is recommended to use this version in case you encounter any problems.
The easiest way to install Taxman is to use pip:
pip install taxman
If you wish to build and install Taxman from source, following these steps:
- Clone the repository:
git clone [email protected]:robinmitra/taxman.git
- Install Pipenv if it isn't already, as this project uses it to help manage dependencies. Once you have Pipenv, install all dependencies (including dev):
pipenv install --dev
- Activate the virtual environment created by Pipenv:
pipenv shell
- Run tests to ensure everything is setup correctly:
make test
- Install the package:
python setup.py install
Run the following to print Income Tax and National Insurance contributions, along with the net income, for a given salary and personal allowance:
taxman calculate --employment-income 85000 --personal-allowance 11850