---
id: nbclient
version: "0.11.0"
license: BSD 3-Clause License Copyright (c) 2020-, Jupyter Development Team All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# nbclient — A client library for executing notebooks. Formerly nbconvert's ExecutePreprocessor.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install nbclient
uv add nbclient
poetry add nbclient

## Description

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter/nbclient/main?filepath=binder%2Frun_nbclient.ipynb)
[![Build Status](https://github.com/jupyter/nbclient/workflows/CI/badge.svg)](https://github.com/jupyter/nbclient/actions)
[![Documentation Status](https://readthedocs.org/projects/nbclient/badge/?version=latest)](https://nbclient.readthedocs.io/en/latest/?badge=latest)

# nbclient

**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.

## Interactive Demo

To demo **NBClient** interactively, click this Binder badge to start the demo:

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter/nbclient/main?filepath=binder%2Frun_nbclient.ipynb)

## Installation

In a terminal, run:

```
python3 -m pip install nbclient
```

## Documentation

See [ReadTheDocs](https://nbclient.readthedocs.io/en/latest/) for more in-depth details about the project and the
[API Reference](https://nbclient.readthedocs.io/en/latest/reference/index.html).

## Python Version...

## AI interpretation — verify before relying

nbclient executes Jupyter notebooks programmatically in various contexts, including the command line, without requiring manual kernel management.

Verdict: nbclient is a stable, actively maintained library from the Jupyter project for programmatic notebook execution. Its low install friction, permissive BSD license, and zero known vulnerabilities make it a reliable choice for automation and batch processing workflows.

[View on SkillFed](https://skillfed.io/packages/nbclient) · [View on PyPI](https://pypi.org/project/nbclient/)