Required dependencies

The astropy-healpix package works with Python 3.7 and later (on Linux, MacOS and Windows), and requires the following dependencies:

If you use Using pip or Using conda, these will be installed automatically.

Optional dependencies

The following packages are optional dependencies, which can be installed if needed:

  • pytest for testing

  • healpy for testing (but this is not required and the tests that require healpy will be skipped if healpy is not installed)

  • hypothesis for the healpy-related tests.

Stable version

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

Using pip

To install astropy-healpix with pip from PyPI simply run:

pip install --no-deps astropy-healpix


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 healpix with Anaconda from the conda-forge channel on simply run:

conda install -c conda-forge astropy-healpix

Testing installation

To check that you have this package installed and which version you’re using, start Python and execute the following code:

$ python
Python 3.6.2 |Continuum Analytics, Inc.| (default, Jul 20 2017, 13:14:59)
[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import astropy_healpix
>>> astropy_healpix.__version__

To make sure that all functionality is working OK on your system, you can run the automated tests of this package by executing the test function:

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

Development version

Install the latest development version from :

git clone
cd astropy-healpix
pip install .


This section contains some tips how to hack on astropy-healpix.

One quick way to get a Python environment with everything needed to work on astropy-healpix (code, run tests, build docs) is like this:

git clone
cd astropy-healpix
conda env create -f environment-dev.yml
conda activate astropy-healpix

Run this command to do an in-place build and put this local version on your Python sys.path:

python develop

To run the tests, use pytest directly:

python -m pytest -v astropy_healpix

To build the docs, use this command:

python build_docs
open docs/_build/html/index.html

If you have any questions, just open an issue on Github and we’ll help.