This library requires Python 3.8 or higher.


Whichever OS you are running, you will need to install at least TensorFlow or PyTorch. You can refer to their corresponding installation pages to do so:

For MacBooks with M1 chip, you will need some additional packages or specific versions:

If you are running another OS than Linux, you will need a few extra dependencies.

For MacOS users, you can install them using Homebrew as follows:

brew install cairo pango gdk-pixbuf libffi

For Windows users, those dependencies are included in GTK. You can find the latest installer over here.

Via Python Package

Install the last stable release of the package using pip:

pip install python-doctr

We strive towards reducing framework-specific dependencies to a minimum, but some necessary features are developed by third-parties for specific frameworks. To avoid missing some dependencies for a specific framework, you can install specific builds as follows:

pip install "python-doctr[tf]"

Via Conda (Only for Linux)

Install the last stable release of the package using conda:

conda config --set channel_priority strict
conda install -c techMindee -c pypdfium2-team -c bblanchon -c defaults -c conda-forge python-doctr

Via Git

Install the library in developer mode:

git clone
pip install -e doctr/.[tf]