astroplan works on Linux, Mac OS X and Windows. It requires Python 2.7 or 3.5+ (2.6 and 3.2 or earlier are not supported, 3.3 and 3.4 may work) as well as the following packages:

Optional packages:

For testing:

First-time Python users may want to consider an all-in-one Python installation package, such as the Anaconda Python Distribution which provides all of the above dependencies.


You can install the stable version of astroplan from PyPI with:

pip install astroplan

or from anaconda:

conda install -c conda-forge astroplan

Alternatively, you can install the latest developer version of astroplan by cloning the git repository:

git clone

…then installing the package with:

cd astroplan
python install


If you want to check that all the tests are running correctly with your Python configuration, start up python, and type:

import astroplan

If there are no errors, you are good to go!


If you want to run the tests that access the internet, you’ll need to replace the last line above with astroplan.test(remote_data=True) and have an active connection to the internet. Also, if you want the tests that check plotting to work, you need Matplotlib and pytest-mpl.


astroplan follows Astropy’s guidelines for affiliated packages–installation and testing for the two are quite similar! Please see Astropy’s installation page for more information.