Skip to content

Creating Notebooks

Deploy a new JupyterLab notebook instance from the UI or via the Admin Chat assistant.

  1. Navigate to Jupyter Notebooks in the sidebar
  2. Click New Notebook
  3. Fill in the form:
FieldRequiredDescription
NameYesUnique identifier (lowercase, alphanumeric, hyphens). Becomes the URL slug.
OwnerNoAssign an owner user for object-level access control
Resource PresetNoChoose a preset or configure custom resources
  1. Click Create

The notebook pod starts within a few seconds. Once status shows Running, click Open to access JupyterLab.

PresetCPUMemoryGPUUse Case
Standard1 core2GiGeneral exploration, small datasets
Medium2 cores4GiModerate data processing
Large4 cores8GiLarge datasets, multi-model inference
CustomconfigurableconfigurableoptionalSpecific requirements

For GPU workloads, select Custom and set the GPU count. GPU nodes must be available in your cluster — see GPU Configuration.

Each notebook instance includes:

  • openai — for calling Menatic AI models via the OpenAI-compatible API
  • requests — HTTP client
  • ipywidgets — interactive widgets
  • papermill — for running notebooks programmatically

An Example.ipynb is pre-seeded showing how to connect to the platform’s LLM API.

The following environment variables are automatically injected:

VariableValue
FTN_BASE_URLIn-cluster backend URL
FTN_API_KEYProject-scoped API token
FTN_PROJECT_IDOwning project UUID
JUPYTER_TOKENAuto-generated JupyterLab auth token

Each notebook is accessible at:

https://<domain>/jupyter/<name>/

The platform generates a token-secured auto-login URL for each notebook. This URL includes the Jupyter token and logs you in automatically. It is displayed in the notebook detail view.

You can create notebooks via the Admin Chat assistant:

Create a new Jupyter notebook named "data-analysis" for user john@example.com

The assistant uses the create_jupyter_notebook tool to deploy the instance and returns the access URL.

Notebook names must:

  • Be lowercase
  • Contain only letters, numbers, and hyphens
  • Start with a letter
  • Be unique within the cluster