Notebook Sessions

The Jupyter section of the BioLM Console lets you launch Notebook Sessions—interactive, embedded Jupyter environments preconfigured for use with the BioLM SDK.

Sessions come authenticated with your workspace and can access assets like Volumes and Protocols, allowing you to start analyzing data or running models without any local setup.

Overview

Notebook Sessions are lightweight, temporary workspaces for experimentation, prototyping, and analysis.

Each session runs a cloud-hosted instance of JupyterLab that includes:

The BioLM SDK preinstalled and ready to use
Automatic authentication with your BioLM API tokens
Access to your workspace’s Volumes and Protocols
A configurable session timeout for automatic cleanup

Sessions are free during the beta period and are ideal for short, interactive tasks rather than long-running workloads.

Starting a New Session

Navigate to the Jupyter tab in your workspace.
Click + New Session.
Select a Session Timeout (e.g., 90 minutes).
(Optional) Attach one or more Volumes for persistent storage.
- Attached Volumes are mounted under /home/biolm/workspace/volumes/<name> .
Click Create Session to launch your notebook.
Once active, click Open to enter the JupyterLab environment.

You can also copy the session link to share access or terminate a session at any time.

Managing Sessions

The Notebook Sessions page lists your active and past sessions, showing details such as:

Session name and creation time
Timeout duration
Owner and access level
Quick actions: Open, Copy Link, or Terminate

Expired sessions will automatically terminate after the configured timeout period.

Working in JupyterLab

Once your session is active, you’ll see the familiar JupyterLab interface, including:

A file browser with access to tutorials and attached Volumes
Launch options for Python notebooks, consoles, and terminals
A fully configured Python environment with the biolm SDK preloaded

You can use Notebook Sessions to:

Run BioLM SDK commands and API calls interactively
Access and analyze datasets stored in Volumes
Test model predictions or Protocol integrations in real time
Save notebooks and outputs directly within your workspace

Best Practices

Use Notebook Sessions for exploration and quick experimentation.
Store data and results in Volumes to persist across sessions.
For larger or ongoing projects, organize work in Team Workspaces and Environments.
When you’re ready to move beyond the console, export notebooks for local or production use.

Notes

Sessions are isolated and scoped to your workspace environment.
Attached Volumes persist beyond session termination.
Each session runs in a secure, temporary container that automatically cleans up when closed.
The Notebook Sessions feature is currently free in beta.