Brought to you by NumFOCUS Foundation and O’Reilly Media
The official Jupyter Conference
Aug 21-22, 2018: Training
Aug 22-24, 2018: Tutorials & Conference
New York, NY

How to build on top of Jupyter’s protocols

Kyle Kelley (Netflix)
1:30pm–5:00pm Wednesday, August 22, 2018
Core architecture
Location: Murray Hill A Level: Intermediate
Average rating: **...
(2.00, 3 ratings)

Who is this presentation for?

  • Software developers

Prerequisite knowledge

  • A working knowledge of HTTP REST APIs (GET, POST on resources), JavaScript (primarily browser based), Node.js, and Promises

Materials or downloads needed in advance

  • A laptop with Node.js v8.x and the React devtools installed

What you'll learn

  • Understand how Jupyter works under the hood, the trade-offs between maintainability, usability, and security, and what you can do to move protocols forward by contributing across the Jupyter ecosystem


Jupyter isn’t just a notebook, a console, or a web app. It’s an establishment of well-defined protocols and formats. It’s a community of people who come together across the sciences, academia, and industry  to build interactive computing experiences and share their knowledge.

The direction of the Jupyter projects (Notebook, Console, JupyterLab, nteract) may not meet everyone’s specific needs and workflows. Luckily, with strong support by Jupyter’s solid foundation of protocols to communicate with the interpreters (Jupyter kernels) and document formats (e.g., .ipynb), you can build your the ideal interactive computing environment for your specific needs. Better yet, with a deeper understanding, you’ll be able to make waves on current Jupyter applications and drive them forward.

Kyle Kelley walks you through creating a new web application from the ground up, teaching you how to build on top of Jupyter’s protocols in the process. Along the way, you’ll learn about Jupyter’s REST and streaming APIs, message spec, and the notebook format.

Topics include:

  • The message spec and wire protocol
  • The REST APIs of the notebook server
  • The notebook format
  • Common ways of thinking about frontend state
  • Influencing the protocols for the future
Photo of Kyle Kelley

Kyle Kelley


Kyle Kelley is a senior software engineer at Netflix, a maintainer on, and a core developer of the IPython/Jupyter project. He wants to help build great environments for collaborative analysis, development, and production workloads for everyone, from small teams to massive scale.