nbtoolbelt

library2026.4.1pypypi✓ verified 79d ago

nbtoolbelt (version 2024.7.2) provides tools to work with Jupyter notebooks programmatically. It supports tasks like merging, splitting, executing, and converting notebooks. Released as a companion to jupyter-releaser, with regular updates.

data devops

pip install nbtoolbelt

package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · NBTOOLBELT

nbtoolbelt

datapythonv2026.4.1

Install

12.0s avg

Import

—

Disk

201MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2026.4.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 197.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 12.0s · import 0.000s · 186MB

201MB installed

● package 201MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Notebook

✓ from nbtoolbelt import nb_cell_stats

✗ from nbtoolbelt import Notebook

Load a Jupyter notebook and print the source of the first cell.

from nbtoolbelt import Notebook nb = Notebook.from_path('example.ipynb') print(nb.cells[0].source)

Debug

Known issues

breakingThe library uses calendar versioning (YYYY.MM.MICRO). Major changes can occur between minor versions; pin your dependency (nbtoolbelt>=2024.7,<2025) to avoid unexpected breaks.

fix

Pin to a specific major version range in requirements.txt.

affects: all

gotchaNotebook.from_path() does not verify the notebook file is valid JSON. Invalid notebooks cause cryptic errors during cell access.

fix

Wrap in try/except or validate JSON beforehand.

affects: all

deprecatedThe old API using nbformat as a dependency directly may be removed. Use Notebook objects instead.

fix

Migrate to nbtoolbelt's Notebook API.

affects: all

Upgrade

Version history

2026.4.1latest on PyPI · released May 1, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/nbtoolbelt/ ↗

homepagehttps://gitlab.tue.nl/jupyter-projects/nbtoolbelt ↗

docshttps://nbtoolbelt.readthedocs.io/ ↗

changeloghttps://gitlab.tue.nl/jupyter-projects/nbtoolbelt/-/blob/master/CHANGELOG.rst ↗