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+ verisons. 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