• Windows
• macOS
• Linux

Download the latest version of Python and install selecting the "Customize installation" option.

In the "Advanced Options" menu, make sure the "Add Python to environment variables" box is ticked.

When the installation has been completed, open the windows command prompt (cmd), and check what version of Python you have by typing python --version.

If you get a version number Python is working correctly. You can now follow the instructions below to either install the latest pip release or the "unreleased" GitHub version of BittyTax.

The pip commands should also be entered via the windows command prompt (cmd) or windows terminal.

First, follow these instructions to install Homebrew if not already installed.

Then, use Homebrew to install Python using the command:

brew install python

Once Python is installed, follow the instructions below to either install the latest pip release or the "unreleased" GitHub version of BittyTax.

Use the Terminal application to enter the commands, for macOS use pip3 instead of pip.

Follow these instructions to install Python if not already installed.

Once installed, follow the instructions below to either install the latest pip release or the "unreleased" GitHub version of BittyTax.

On some Linux distributions, the pip command is meant for Python 2 and pip3 is used for Python 3.

On Ubuntu 24.04 or greater you will need to use pipx. This installs BittyTax in an isolated environment to avoid conflicts. You may find pipx is required on other Linux distributions too.

If you get errors during installation regarding reportlab, install the freetype package.

sudo apt-get install libfreetype6-dev

This will install the latest official release from PyPI which has been fully tested, and is recommended for new users.

pip install BittyTax

Once installed correctly all the BittyTax tools (bittytax, bittytax_conv, bittytax_price) should run from within any directory.

If you get errors during installation regarding pycairo. Install the spoof svglib package as shown below, this removes the dependency on pycairo. Then re-attempt the installation of BittyTax.

pip install https://github.com/BittyTax/BittyTax/archive/refs/heads/master.zip#subdirectory=src/svglib

Installing the "unreleased" version from GitHub, you will be getting all the latest fixes and changes, but may not have been as thoroughly tested as an official release.

Install BittyTax via the ZIP archive:

pip install https://github.com/BittyTax/BittyTax/archive/refs/heads/master.zip

Alternatively, if you have git installed, install using:

pip install git+https://github.com/BittyTax/BittyTax

Check the new version has been installed successfully:

pip show BittyTax

If you get problems you can try uninstalling first:

pip uninstall BittyTax

If you get errors during installation regarding pycairo. Install the spoof svglib package as shown below, this removes the dependency on pycairo. Then re-attempt the installation of BittyTax.

pip install https://github.com/BittyTax/BittyTax/archive/refs/heads/master.zip#subdirectory=src/svglib

Check the CHANGELOG to see what changes are included in the "unreleased" version.