Installing additional packages


Do not install packages by running !pip install <package-name> inside your Jupyter Notebook. This causes the package to be installed every time you run the pipeline step. It is not saved in the environment as containers are stateless!

Orchest runs all your individual pipeline steps (e.g. .ipynb or .R scripts) in containers. The default images are based on the Jupyter Docker Stacks and come with a number of pre-installed packages.

To install additional packages or to run other terminal commands inside the base image, we support custom Environments. We essentially create a new image by running your script inside the selected base image.

Build an environment

  1. Simply go to Environments in the left menu pane.
  2. Create a new Environment. Environments are part of a single project.
  3. Choose an Environment name.
  4. To keep environment image sizes to a minimal, each environment is tied to a specific programming language. Choose one of the supported languages for your environment.
  5. Choose a base image. This image will be extended through your setup bash script.
  6. Install additional packages, e.g. pip install tensorflow or apt install vim.


The shell script that installs the additional packages is run inside the /project-dir, meaning that you can directly interact with your project files from within the script. For example:


# Install any dependencies you have in this shell script.

# E.g. pip install tensorflow
pip install -r requirements.txt