Welcome to nbclient#

GitHub stars GitHub Actions CodeCov

NBClient lets you execute notebooks.

A client library for programmatic notebook execution, NBClient is a tool for running Jupyter Notebooks in different execution contexts, including the command line. NBClient was spun out of nbconvert’s former ExecutePreprocessor.


To demo NBClient interactively, click the Binder link below:



This library used to be part of nbconvert and was extracted into its ownlibrary for easier updating and importing by downstream libraries and applications.

Python Version Support#

This library currently supports python 3.6+ versions. As minor python versions are officially sunset by the python org, nbclient will similarly drop support in the future.


These pages guide you through the installation and usage of nbclient.

API Reference#

If you are looking for information about a specific function, class, or method, this documentation section will help you.

Indices and tables#