nteract

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