Skip to main content

Jupyter Kernel Not Named

engine
The document’s jupyter: key is a map that names no kernel, or uses the kernelspec: object form; Quarto ignores it and picks the kernel from the first language in the document that has one.

Q-18-4 — Jupyter Kernel Not Named

The document’s jupyter: key is a map that names no kernel, or uses the kernelspec: object form; Quarto ignores it and picks the kernel from the first executable cell.

What this means

jupyter: python3 selects the kernel for the whole document, and so does jupyter: {kernel: python3}. Two other shapes name no kernel that Quarto can use:

  • a map with no kernel key, such as jupyter: {python: python3};
  • Quarto 1’s jupyter: {kernelspec: {...}} object form.

Quarto 1 stops with “Invalid Jupyter kernelspec” for both. Quarto 2 warns and continues: it uses engine: [{jupyter: {kernel: ...}}] if the document has it, and otherwise the kernel for the first language in the document that has an installed kernel.

How to fix

Name the kernel directly:

jupyter: python3

or

jupyter:
  kernel: python3

Use --strict to make this warning stop the render:

q2 render --strict