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 conda (recommended)¶
conda install -c wwt pywwt
This will automatically install pywwt, its dependencies, and will enable the Jupyter extension.
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 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:
- Python 2.7, or 3.5 or later
- NumPy 1.9 or later
- Matplotlib 1.5 or later
- Astropy 1.0 or later
- Beautiful Soup 4
- ipywidgets 7.0.0 or later
In addition, if you want to use the Qt widget, you will need:
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.