Skip to main content


Sessions has a variety of fully managed Jupiter environments for developing VSCode notebooks, python files, and Jupyter notebooks.

To spin up a Sessions instance, go to the Sessions tab on the dashboard and start a new session.

Below is a list of pre-built for a quick start.

Display NameImage NameBest ForKey Packages
Minibasicminibasicbasic data processingnumpy, pandas
Basicbasicdata sciencenumpy, scipy, scikit-learn, Dask
Deep learningdldeep learningTensorFlow, Pytorch, MXNet, transformers
GPUgpumachine learning with GPURapids TensorFlow Pytorch
Triton model servingtritonmodel serving with tritontritonclient
Ray Sparkraysparkdata engineering with spark on rayRay raydp Spark
Rayraydistributed training, hyperparameter tuningRay
Cryptocryptocrypto trading and DAppsccxt web3
Climateclimatelarge scale climate data processingxclim Pangeo xarray
SAS on Jupytersasrun sas code in jupyter and integrate with pythonsaspy
R on Jupyterrstatrun R code in jupyter and integrate with pythonrstat
Rustrustbuilding DAppsrust, cargo, SOL SDK
Customcustomuse your own Docker image-

PodSpec details

To check the configurations for each podspec navigate to the podspec tab and click on the podspec card you'd like to see the details for.

podspec details

Check installed packages

To check what packages are installed in a podspec type, you can do so from Sessions.

  1. Create a new session and choose the session type for which you'd like to check the packages for.

  2. Open up the browser Session and open a Jupyter notebook.

  3. Type in pip freeze to see pip packages installed and conda list for conda packages installed.

Create a podspec


These are a few requirements when creating a podspec:

  • An image that is accessible to Shakudo
  • Volumes and volume mounts to exist
  • Appropriate node pools or resources

Steps to create a podspec

You can create a new podspec to use in your Sessions, Jobs, or Services. Follow the steps below to do so:

  1. Navigate to the podspecs tab and click on the + button to create a new podspec

  2. Customize the details. For details on each field, see the section below for podspec configurations

  3. Click CREATE

  4. To view and use the new podspec you must press + R to hard refresh the page.

Podspec configurations


This is the name that will show up when choosing which podspec to use in Sessions, Jobs, and Services.

Podspec name

This name acts as a unique ID for the podspec.


Give the podspec a one liner description for when someone should pick it. This description appears in the podspec page as well as in the Session Type selection.

session type description


The icon is a quick way to identify your podspec. Choose any icon by clicking on the smiling face button on the right side of the field.

Image URL

You can choose to bring your own docker image to build your custom podspec with. Paste in the link to the image in this field. For more information on how to build your own image that is compatible with the Shakudo platform check out the advanced guide on custom images.


You can specify the CPU request & limit as well as the memory request & limit.

If you want GPUs make sure to specify GPUs that are available to your cluster. If you're unsure please contact us and we can provide you the details.

Volumes & volume mounts

Specify your Volumes and Volume Mounts to attach by clicking on the + button. For more information see the Kubernetes guide on Volumes.

Environment variables

Use this field to specify the name and value for environment variables.

Edit a podspec

You can edit details of a podspec by clicking on the pencil icon from the podspec tab. By default you can only edit the custom created podspecs (not the default podspecs created by Shakudo)

When a podspec is edited and saved, newly created jobs and sessions will use the updated version. Any jobs or sessions currently in progress will use the old version. Any services in progress using the edited podSpec will be restarted to update.