Installation

Try without installing

If you want to try out the WorldWide Telescope Jupyter widget without installing anything locally, note that you can do so by viewing an example Jupyter notebook online at mybinder.org (once you click on the link you may need to wait for up to a minute before the notebook appears).

Installing pywwt with pip

You can also install the latest release of pywwt using pip:

pip install pywwt

If you want to use the Jupyter widget, you will need to also enable the extension using:

jupyter nbextension enable --py --sys-prefix pywwt

If you want to use the Qt widget, you will need to install PyQt or PySide separately.

Dependencies

If you install pywwt using pip or conda as described above, any required dependencies will get installed automatically (with the exception of PyQt/PySide if using pip). For the record, these dependencies are as follows:

In addition, if you want to use the Qt widget, you will need:

  • PySide or PyQt (both PyQt4 and PyQt5 are supported)
  • QtPy 1.2 or higher

Installing the developer version

If you want to use the very latest developer version version, you can clone this repository and install the package manually (note that this requires npm to be installed):

git clone https://github.com/WorldWideTelescope/pywwt.git
cd pywwt
pip install -e .

If you want to use the Jupyter widget, you will also need to run:

jupyter nbextension install --py --symlink --sys-prefix pywwt
jupyter nbextension enable --py --sys-prefix pywwt

If you use conda, you can alternatively install a recent developer version using:

conda install -c conda-forge -c wwt/label/dev pywwt

This will install a version built in the last 24 hours so may not strictly be the absolute latest version in some cases.