Local Installation#


These tutorials can be run:

  • In a web browser using a cloud-based service. This the easiest way to get started because you do not need to install anything. Visit https://mybinder.org/v2/gh/bluesky/tutorials/main.

  • Using Docker, run as docker run -p 8888:8888 nsls2/tutorials:latest.

However, if you prefer a direct local installation, instructions follow.


  • We strongly recommend creating a fresh software environment. For example, using conda:

    conda create -n bluesky-tutorials python=3.7
    conda activate bluesky-tutorials
  • You will need git. You can install that using conda, for example, or from https://git-scm.com/downloads.

    conda install git
  • Ensure pip, setuptools, and numpy are up to date. This helps avoid some pitfalls in the steps to follow.

    python -m pip install --upgrade pip setuptools numpy
  • Clone this repository.

    git clone https://github.com/bluesky/tutorials
    cd tutorials
  • Install the requirements.

    python -m pip install -r binder/requirements.txt
    python -m pip install -e ./bluesky-tutorial-utils  # MUST use -e here
  • Start Jupyter.

    jupyter lab