The hips package works with Python 3.6 or later, on Linux, MacOS and Windows.

Installing the latest stable version is possible either using pip or conda.

How to install the latest development version is desribed on the Develop page.

Using pip

To install hips with pip from PyPI, run:

pip install hips --no-deps


The --no-deps flag is optional, but highly recommended if you already have Numpy installed, since otherwise pip will sometimes try to “help” you by upgrading your Numpy installation, which may not always be desired.

Using conda

To install hips with Anaconda from the conda-forge channel on simply run:

conda install -c conda-forge hips

Check installation

To check if you have hips installed, where it was installed and which version you have:

$ python
>>> import hips  # doctest: +SKIP
>>> hips.__version__  # doctest: +SKIP
# -> prints which version you have
>>> hips  # doctest: +SKIP
# -> prints where hips is installed

To see if you have the latest stable, released version of hips, you can find that version here:

Next you could try running the examples at Getting started and see if you get the expected output.

It’s usually not necessary, but if you find that your hips installation gives errors or unexpected results for examples that should work, you can run the hips automated tests via:

python -c 'import hips; hips.test()'

For more information on automated tests, see the Develop page.


The hips package has the following requirements:

  • Python 3.6 or later!
  • Numpy 1.11 or later
  • Astropy 1.2 or later
  • astropy-healpix 0.2 or later
  • scikit-image 0.12 or later. (Older versions could work, but aren’t tested.)
  • Pillow 4.0 or later. (Older versions could work, but aren’t tested.) Pillow is the friendly Python Imaging Library (PIL) fork, for JPEG and PNG tile I/O.

In addition, the following packages are needed for optional functionality:

  • Matplotlib 2.0 or later. Used for plotting in examples.
  • tqdm. Used for showing progress bar either on terminal or in Jupyter notebook.
  • aiohttp. Used for fetching HiPS tiles.

We have some info at Why only Python 3? on why we don’t support legacy Python (Python 2).