Edit code cells, write markdown, visualize!
Checkout our Medium blog post to see what amazing things you can do with nteract.
Note: There will be
.ipynb on the desktop, use Spotlight on the Mac. It Just Works™
Scope and goals
- Notebook environment to explore and get things done
- Standalone cross-platform desktop application
- One notebook document/narrative per window
- Work with any Jupyter kernel using message spec v5
- Easy install with pre-configured Python3
- Grow an ecosystem of tooling to allow others to build their own platforms relying on the Jupyter specifications
Installation - Users
Head to the Releases page and download the version for your OS.
Installation - Contributors and Development
The contributors are listed in contributors
To learn how to contribute, head to our contributing guide.
Feel free to post issues or chat in Slack (request an invite) if you need help or have questions. If you have trouble creating an account on Slack, either email [email protected] or post an issue on GitHub.
At least for now, we need the python 3 kernel installed when hacking on nteract:
python3 -m pip install ipykernel python3 -m ipykernel install --user
nteract in dev mode
Requires Node.js and npm 3+.
- Fork this repo
- Clone it
git clone https://github.com/nteract/nteract
cdto where you
npm run start
As you make changes, close the entire app (cmd-q on OS X, or ctrl-c at the terminal) then run
npm run start again.
Progressive Webpack build for the notebook
In separate terminals run:
npm run build:desktop:watch
npm run spawn
The webpack build will keep occurring as you modify source. When you open a new notebook, you'll get the freshest copy of the notebook app.
You can run nteract's documentation generator by running
npm run build:docs
And then opening
docs/index.html in your favorite browser.
I upgraded my developer installation and things are broken!
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 'Do you want the application "nteract Helper.app" 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/nteract.app. You will have to do this again every time you rebuild the app.
For maintainers: Creating a release
Allow lerna to publish all of
$ lerna publish ... follow prompts to publish any packages, choosing the appropriate semver
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
If your employer allows you to work on nteract during the day and would like recognition, feel free to add them to the "Made possible by" list.