I’m excited to announce ReviewNB, a tool that helps you version control & code review Jupyter Notebooks.
Jupyter is great for data exploration but it’s hard to go beyond that & do any kind of collaborative work with it. Following challenges exist in using Jupyter Notebooks with modern version control system like Git,
- Notebook diffs are hard to read. Hence we can’t do code reviews on GitHub
- Merging in remote changes is hard due to JSON format of Notebook files (.ipynb)
- No easy way to share feedback & have discussion around Notebooks
- It’s not easy to reproduce Notebook results
- It’s not easy to test notebook code cells
ReviewNB aims to tackle some of these problems starting with diff & code reviews,
- We built a best in class visual diff for notebooks. More examples on our homepage.
- You can browse GitHub commits /pull requests & write comments on notebook cells to suggest improvements, seek clarification, or just applaud your colleague’s work!
How does it work?
- ReviewNB is a GitHub App available on the GitHub marketplace (app is verified by GitHub)
- ReviewNB communicates with GitHub APIs to fetch the notebook changes made in a commit or a pull request. We process these changes (git patches) and compute the diff to highlight modifications done to a notebook.
- We show these changes to user in a side-by-side diff format. All notebook contents (markdown, code, images, formulas) are rendered as you would see in the Jupyter UI. This visual diff is much more readable than the messy JSON diff common to Notebooks.
- All the discussion comments are posted back to GitHub PR for storage.
ReviewNB is super simple to use. It does not require any local installation or configuration. One can start using it on their GitHub repositories in under a minute.
- Anyone can install the app on GitHub and select repositories that ReviewNB will have access to (~30 seconds).
- Once logged in, you can browse Commits or Pull Requests on your repositories.
- That’s it! You can start seeing visual diff for any commit or pull request & start having discussion with your peers (commenting is only available for pull requests).
Contribute to our Roadmap
We’re building in the open. You can view upcoming features, vote on them, and even request a new one.
That’s all for now! There’s more information on our website along with an elaborate FAQ section for other questions you might have. We also offer self hosting option for companies interested in running ReviewNB on their own. I’m available on firstname.lastname@example.org if you have any questions. Try out ReviewNB and let me know what you think of it!