Skip to main content
lyceum notebook launch provisions a machine, starts a Jupyter notebook server on it, and prints the URL once it’s ready. You connect to the server in your browser and work in JupyterLab as you would locally. This is the right tool when you want an interactive notebook session on a GPU machine without managing a VM yourself. The session bills for as long as the notebook server is up; stop it from the CLI when you’re done. For one-shot batch execution of an existing .ipynb file, submit it as a Python run instead — see Launch a Run.

Launching a notebook

lyceum notebook launch -m gpu.a100
FlagDefaultDescription
-m, --machinecpuHardware profile
-t, --timeout600Session timeout in seconds (max 600)
-i, --imagejupyter/base-notebook:latestCustom Jupyter image
--tokenlyceumJupyter notebook token
-p, --port8888Port for the Jupyter server
The CLI prints the notebook URL once the server is ready. Open it in your browser to start working.

Listing and stopping

lyceum notebook list                # list active sessions
lyceum notebook stop <execution_id> # stop a session
The session shows up in lyceum workloads list like any other execution, with logs and metrics available through the same endpoints.