jwst is also available as part of
stenv (Space Telescope Environment).
Detailed Installation Instructions
jwst package can be installed into a virtualenv or conda environment via
pip. We recommend that for each installation you start by creating a fresh
environment that only has Python installed and then install the
and its dependencies into that bare environment. If using conda environments,
first make sure you have a recent version of Anaconda or Miniconda
installed. If desired, you
can create multiple environments to allow for switching between different
versions of the
jwst package (e.g. a released version versus the current
In all cases, the installation is generally a 3-step process
Create a conda environment
Activate that environment
Install the desired version of the
jwstpackage into that environment
Details are given below on how to do this for different types of installations, including tagged releases, DMS builds used in operations, and development versions. Remember that all conda operations must be done from within a bash/zsh shell.
The jwst package requires a C compiler for dependencies and is currently limited to Python 3.9, 3.10, or 3.11. Until Python 3.12 is supported, fresh conda environments will require setting the Python version to <=3.11.
Users on MacOS Mojave (10.14) should limit their environment to python 3.9 - there is a package dependency that currently fails to build on Mojave with python>=3.10.
Installing Latest Release
You can install the latest released version via
pip. From a bash/zsh shell:
>> conda create -n <env_name> python=3.11>> conda activate <env_name>>> pip install jwst
Installing Previous Releases
You can also install a specific version (from
jwst 0.17.0 onward):
>> conda create -n <env_name> python=3.11>> conda activate <env_name>>> pip install jwst==1.12.5
Installing the Development Version from Github
You can install the latest development version (not as well tested) from the Github master branch:
>> conda create -n <env_name> python=3.11>> conda activate <env_name>>> pip install git+https://github.com/spacetelescope/jwst
Upgrading Installed Version
Do NOT use
pip install jwst --upgrade to upgrade your
installation. This does not check if dependencies are upgraded and will cause
issues. Instead, use the method detailed below.
If you have previously installed
jwst and you would like to upgrade to keep your
install up-to-date, we recommend that you first uninstall the package in your
environment of choice and then reinstall:
>> pip uninstall jwst>> pip install jwst
This will ensure that all dependency packages are also upgraded. This also applies when using the development version of jwst - to upgrade and grab recent changes, uninstall and re-install the master branch from Github:
>> pip uninstall jwst>> pip install git+https://github.com/spacetelescope/jwst
jwst is available as part of
stenv, a set of installable Conda
environments that bundle software for astronomical data analysis with JWST, HST,
and other observatories. See the stenv documentation
for more information.
For more install instructions, including how to install jwst for development or how to install a DMS operational build, see the Github README.