Welcome to nbclient

GitHub stars GitHub Actions CodeCov

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

NBClient lets you execute notebooks.


To demo NBClient interactively, click the Binder link below:



This library used to be part of nbconvert and was extracted into its own library 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.

Indices and tables