Skip to main content
Use the toolbar at the top of each notebook to pick its kernel, run cells, and stop or restart execution. A kernel is the process that runs a notebook’s code, such as a Python 3.12 interpreter in a virtual environment. Each notebook has its own kernel; notebooks never share a running kernel. A notebook’s kernel starts when you run its first cell.

Choose a kernel

Click the kernel button at the left of the toolbar. It shows the kernel’s name, environment path, and status, such as Ready or Busy. In the menu, click a kernel to switch this notebook to it.
  • Click Refresh kernels after you install a new interpreter or environment.
  • On the desktop app, click Discover kernels to search a folder for Jupyter kernels that Qualia didn’t find.
To set up Python, R, or Julia environments, see General settings.

Toolbar actions

Use the toolbar to interrupt the running cell, run all or some cells, clear outputs, or restart or shut down the kernel. Restarting starts a fresh kernel, which clears all variables. When the notebook is narrow, actions that don’t fit move into the More notebook actions menu. For keyboard shortcuts, see Notebooks. While a cell runs, click Executing… in the toolbar to scroll to the running cell.

Set the default kernel

To choose the kernel that notebooks without a saved kernel open with, go to Settings > Notebooks > Default Kernel. If the default kernel disappears, for example because you deleted its virtual environment, Settings shows which kernel Qualia uses instead.

Kernels in Qualia Cloud

In Qualia Cloud, notebooks run on managed compute, so the menu lists what that compute provides rather than what is on your machine. The Compute group lets you move this notebook between CPU and GPU compute; switching restarts the kernel.
  • Python runs on all cloud compute types.
  • R and Julia run on CPU compute, in the same managed environment as Python. Julia notebooks use Julia 1.11. R and Julia on GPU compute aren’t available yet.
Qualia records the Python packages you install in a cloud workspace and reinstalls them when compute restarts. R and Julia packages last only until that compute shuts down, so install them again in a fresh environment.

Fix kernel problems

Kernel won’t start

  • Check that the Python, R, or Julia installation still exists.
  • Read the error next to the kernel name in the kernel menu.
  • Click Refresh kernels after installing or moving an environment.
On the desktop app, if a notebook’s saved environment is gone, Qualia starts the notebook on another installed kernel of the same language. The notebook keeps its original kernel choice, so rebuilding that environment brings it back.

Kernel keeps dying

  • Check your system’s free memory, because running out of memory is a common cause of crashes.
  • Try the package in a fresh environment if you suspect a broken install.

Packages are missing

If an import fails for a package you installed, check that the path in the kernel button matches the environment you installed it into. Don’t install packages into a different interpreter than the one the notebook runs, because the kernel can only import from its own environment.