astroplan works on Linux, Mac OS X and Windows. It requires Python 3.7+ as well as numpy, astropy, pytz, and six. Additional features are available when you install Matplotlib and astroquery.

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
pip install .


If you want to check that all the tests are running correctly with your Python configuration, run the following from the command line:

tox -e test

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 tox -e test -- --remote-data 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.