nteract
A fast, modern toolkit for Jupyter notebooks. Native desktop app with instant startup, realtime sync across windows and agents, and intelligent environment management.
Built on jupyter-zmq-client and jupyter-protocol.
Install
Download the latest release from GitHub Releases.
Linux desktop users should use the AppImage from GitHub Releases; see
Linux install options. DEB/RPM/APT installs are not currently
supported because runtimed is a per-user daemon managed by the app and CLI,
not by system package-manager scripts.
The desktop app bundles everything — runt CLI and runtimed daemon.
The runt CLI and runtimed Python bindings ship with the app and stay up to date automatically. For nightly builds, use runt-nightly instead.
What's in here
| Component | Description |
|---|
nteract | Desktop notebook editor (Tauri + React) |
runtimed | Background daemon — environment pools, notebook sync, kernel execution |
runt | CLI for managing kernels, notebooks, and the daemon |
runtimed (Python) | Python bindings for the daemon (ships with the app) |
MCP Server
The nteract MCP server connects AI assistants to Jupyter notebooks through the daemon. Agents can run code, read and write cells, manage dependencies, and collaborate with humans in real-time — watching the notebook update live in the desktop app while the agent works.
Install the Codex plugin
codex plugin marketplace add nteract/agent-plugins
Restart Codex, then open the plugin directory, choose the nteract marketplace, and install nteract.
The distribution repository also includes a nightly plugin entry for pre-release builds.
Install the Claude Code plugin
/plugin marketplace add nteract/agent-plugins
/plugin install nteract@nteract
Pin a specific version:
/plugin install nteract@nteract --ref v2.3.0
The plugin ships the right nteract-mcp binary for your platform (macOS arm64/x64, Linux x64, Windows x64) — no separate install needed. main of nteract/agent-plugins always points at the latest stable release.
For pre-release builds (updated daily):
/plugin install nightly@nteract
Install in Claude Desktop
If you use the nteract desktop app with Claude Desktop, there's a one-click install path. In the menu bar, choose nteract → Install Extension for Claude...
The desktop app builds a .mcpb bundle at runtime (manifest, icons, nteract-mcp binary) and hands it to Claude Desktop, which prompts you to confirm the install. Requires the nteract desktop app; Claude Desktop picks up the bundle from there.
Usage
# Open a notebook
runt notebook path/to/notebook.ipynb
# MCP server for notebook automation
runt mcp
# Daemon management
runt daemon status
runt daemon logs -f
List open notebooks with kernel and environment info:
$ runt notebooks
╭──────────────────────────────────────┬────────┬──────────────┬────────┬───────╮
│ NOTEBOOK │ KERNEL │ ENV │ STATUS │ PEERS │
├──────────────────────────────────────┼────────┼──────────────┼────────┼───────┤
│ ~/notebooks/blobstore.ipynb │ python │ uv:inline │ idle │ 1 │
│ d4c441d3-d862-4ab0-afe6-ff9145cc2f3d │ python │ uv:prewarmed │ idle │ 1 │
╰──────────────────────────────────────┴────────┴──────────────┴────────┴───────╯
Project structure
