SunPy relies on and enables the use of the wider ecosystem of scientific Python packages for solar physics. Therefore a working SunPy installation is more about installing the scientific Python ecosystem than SunPy itself. SunPy v1.X or greater is compatible with Python 3.6+. If you still want a Python 2 version, you have to install SunPy v0.9.X.

If you are new to Python and scientific Python then continue to follow this guide to get setup with the whole environment. If you already have a working Python / Scientific Python environment then you can skip to the Advanced Installation Instructions section.

Installing Scientific Python and SunPy

If you do not currently have a working scientific Python distribution this guide will set you up with the Anaconda scientific Python distribution. Anaconda makes it easy to install and manage your scientific Python packages. Alternative scientific Python options exist and can be found later in the Advanced Installation Instructions section.

Anaconda contains a free distribution of Python and a large number of common scientific packages. Anaconda is very powerful and easy to use. Installing Anaconda provides (almost) all the packages you need to use SunPy.

To install the Anaconda Python distribution follow the instructions here. You will need to select the correct download for your platform and follow the install procedure. Note that although Anaconda makes it simple to switch between Python versions, we recommend that new users install the latest Python 3.x version of Anaconda as SunPy v1.X only supports Python 3.6+.

Installing SunPy on top of Anaconda

To install SunPy launch a system command prompt or the ‘Anaconda Command Prompt’ (under Windows). First configure conda for sunpy downloads:

conda config --add channels conda-forge

to install SunPy:

conda install sunpy

You now have a working SunPy installation. You can check your SunPy install by following the instructions in Testing SunPy.

Updating SunPy to a New Version

When a new version of SunPy is released you can update to the latest version by running:

conda update sunpy

Advanced SunPy Installation

If you do not wish to use Anaconda to install Scientific Python or you already have a scientific Python installation there are other options for installing SunPy.