Installation | Documentation | Contributing | Development Install | Testing | License | Getting help
nbdime provides tools for diffing and merging of Jupyter Notebooks.
nbdiff compare notebooks in a terminal-friendly waynbmerge three-way merge of notebooks with automatic conflict resolutionnbdiff-web shows you a rich rendered diff of notebooksnbmerge-web gives you a web-based three-way merge tool for notebooksnbshow present a single notebook in a terminal-friendly wayDiffing notebooks in the terminal:
Merging notebooks in a browser:
Install nbdime with pip:
pip install nbdime
See the installation docs for more installation details and development installation instructions.
See the latest documentation at https://nbdime.readthedocs.io.
See also description and discussion in the Jupyter Enhancement Proposal.
If you would like to contribute to the project, please read our contributor documentation and the CONTRIBUTING.md.
To install a development version of nbdime, you will need npm installed and available on your PATH while installing.
For a development install, enter on the command line:
pip install -e git+https://github.com/jupyter/nbdime#egg=nbdime
See installation documentation for additional detail, particularly related to performing a dev install for working on the browser script code.
Install the test requirements:
pip install nbdime[test]
To run Python tests locally, enter on the command line: pytest
To run Javascript tests locally, enter: npm test
Install the codecov browser extension to view test coverage in the source browser on github.
See testing documentation for additional detail.
We use a shared copyright model that enables all contributors to maintain the copyright on their contributions.
All code is licensed under the terms of the revised BSD license.
We encourage you to ask questions on the mailing list.
FAQs
Diff and merge of Jupyter Notebooks
We found that nbdime demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 6 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.
Security News
React's CRA deprecation announcement sparked community criticism over framework recommendations, leading to quick updates acknowledging build tools like Vite as valid alternatives.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.