Execution Libraries

Many execution libraries can be used to display the output of IPython cells. We used nbsphinx to parse and display the outputs presented in PyData Library Styles. In this section we’ll show alternatives that run code for you using a Jupyter like kernel.

JupyterLite

Warning

As of April 2025, we have not found a way to sync JupyterLite widgets with the theme’s light/dark mode. You can see this for yourself if you change this page from light to dark mode. The rest of the page will appear in dark mode but the JupyterLite widget below will still be in light mode. Follow jupyterlite/jupyterlite-sphinx#69 for more information.

jupyterlite-sphinx brings the power of JupyterLite to your Sphinx documentation. It does a full JupyterLite deployment in your docs and provides some utilities for using that deployment easily.

This section demonstrates how it displays in a pydata-sphinx-theme context:

Try Replite!

jupyter-sphinx

Another common library is jupyter-sphinx. This section demonstrates a subset of functionality to make sure it behaves as expected.

import matplotlib.pyplot as plt
import numpy as np

rng = np.random.default_rng()
data = rng.standard_normal((3, 100))
fig, ax = plt.subplots()
ax.scatter(data[0], data[1], c=data[2], s=3)

<matplotlib.collections.PathCollection at 0x7851886b21b0>