Skip to content
📘 Desktop notebook app + packages
Branch: master
Clone or download
Pull request Compare This branch is 4043 commits behind nteract:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

nteract nteract animated logo slack in lerna CircleCI

|| BasicsUsers || ContributorsDevelopmentMaintainers || SponsorsMade possible by ||


nteract is first and foremost a dynamic tool to give you flexibility when writing code, exploring data, and authoring text to share insights about the data.

Edit code, write prose, and visualize.

We support Jupyter kernels locally on your system and on remote JupyterHubs via Binder.


Installing the nteract desktop application

If you're here to install the nteract desktop app, visit to download a binary and install or visit the releases page.

Try the nteract playground

We're still hard at work on the playground. Here's a sneak peek to explore:


The contributors are listed in the contributors page on GitHub.

To learn how to contribute to nteract, head on over to our contributing guide.

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to

Feel free to post issues on GitHub or chat with us in Slack (request an invite) if you need help or have questions. If you have trouble creating an account on Slack, either email or post an issue on GitHub.


Overview of nteract's monorepo

This repository is a monorepo, which basically means that the repository hosts more than one module or application. In our case, we have two main directories:

packages/ -- components used as an individual library
applications/ -- all the user facing applications (i.e. desktop, play)

The packages directory has the components needed to build new applications, and the applications has the desktop app, the play app, and a few more.

Why have a monorepo? The monorepo contains many components and packages that can be mixed and remixed to create new applications. The monorepo keeps these elements together so they are easy to discover and use. Another benefit is that the monorepo makes it easy to iterate on applications that share common components. For example, if we update a component, such as the Jupyter message handling, and happen to introduce an issue when making a change to the desktop app and happened to break it for use by web app we would notice the issue in tandem.

Getting Started

To get started developing, set up the nteract monorepo.

Set the monorepo up in dev mode

Requires Node.js and npm 3+.

  1. Fork this repo
  2. Clone your fork or this repo git clone
  3. cd to the directory where you cloned it
  4. npm install

To keep up-to-date with changes to the root nteract/nteract branch:

  1. Set the root as a remote: git remote add upstream

When changes are made, they can then be pulled from the master branch:

  1. git pull upstream master
  2. npm install

Building a specific package

In some cases you'll want to modify an individual base package (i.e. commutable or transforms) and not rebuild all of the other packages. To target a build of a specific package, use this command, replacing packageName with the package you want to hack on:

$(npm bin)/lerna run build --scope packageName

Hacking on the Desktop application

Quick and dirty (manual)

npm run app:desktop

As you make changes, you will have to close the entire app (CMD-q on macOS or CNTL-c at the terminal) and then run npm run app:desktop again to see the changes.

Progressive Webpack build (automatic)

In separate terminals run:

npm run build:desktop:watch


npm run spawn

This progressive webpack build will keep rebuilding as you modify the source code. When you open a new notebook, you'll get the fresh, up-to-date copy of the notebook app.

Hacking on play


npm run app:play

Then open in your browser. You'll be able to make changes to play and see the changes update live.

If you make changes to any packages/ while hacking on play, you'll want to rebuild those using the instructions for building specific packages.


I upgraded my developer installation and things are broken!

  • Try git clean -xdf && npm i

I want to debug redux actions and state changes.

  • Enable redux-logger by spawning the application with npm run spawn:debug.

I keep getting a pop-up asking: Do you want the application "nteract" to accept incoming network connections? while developing or using a custom build of nteract on macOS.

  • This is how the the macOS firewall behaves for unsigned apps. On a signed app, the dialog won't show up again after approving it the first time. If you're using a custom build of nteract, run:

    sudo codesign --force --deep --sign - /Applications/

    You will have to do this again every time you rebuild the app.


Creating a release

Individual packages

Allow lerna to publish all of packages/*

$ lerna publish
... follow prompts to publish any packages, choosing the appropriate semver

Desktop application

Follow instructions in Releasing the Desktop application.


Work on the nteract notebook is currently sponsored by


We're on a common mission to build a great notebook experience. Feel free to get in touch if you'd like to help. Resources go towards paying for additional work by seasoned designers and engineers.

Made possible by

The nteract project was made possible with the support of

Netflix OSS

If your employer allows you to work on nteract during the day and would like recognition, feel free to add them to this "Made possible by" list.

|| BasicsUsers || ContributorsDevelopmentMaintainers || SponsorsMade possible by ||

You can’t perform that action at this time.