Installing

Which Python?

You’ll need Python >= 3.6 (see Python version compatibility if you require support for older versions).

We recommend using the Anaconda or Miniconda Python distributions to ensure you have all dependencies installed and the conda package manager available. Installing Anaconda does not require administrative rights to your computer and doesn’t interfere with any other Python installations in your system.

Installing with conda

You can install pooch using the conda package manager that comes with the Anaconda distribution:

conda install pooch --channel conda-forge

Installing with pip

Alternatively, you can also use the pip package manager:

python -m pip install pooch

Installing the latest development version

You can use pip to install the latest version of the source code from GitHub:

python -m pip install --upgrade git+https://github.com/fatiando/pooch

Dependencies

The required dependencies should be installed automatically when you install Pooch using conda or pip. Optional dependencies have to be installed manually.

Required:

Optional:

Testing your install

Note

This step is optional.

We ship a full test suite with the package. To run the tests, you’ll need to install some extra dependencies first:

After that, you can test your installation by running the following inside a Python interpreter or Jupyter notebook:

import pooch
pooch.test()

Python version compatibility

If you require support for older Python versions, please pin Pooch to the following releases to ensure compatibility:

Python version

Last compatible Pooch release

2.7

0.6.0

3.5

1.2.0