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 runtimelib and jupyter-protocol.
Download the latest release from GitHub Releases.
The desktop app bundles everything — runt CLI, runtimed daemon, and sidecar.
The Python bindings are available on PyPI:
pip install runtimed| 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 |
sidecar |
Viewer for Jupyter kernel outputs |
runtimed (PyPI) |
Python bindings for the daemon |
For AI agent integration with Jupyter notebooks, see the nteract MCP server.
# Open a notebook
runt notebook path/to/notebook.ipynb
# Interactive console
runt console
# Daemon management
runt daemon status
runt daemon logs -fList 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 │
╰──────────────────────────────────────┴────────┴──────────────┴────────┴───────╯
nteract/desktop
├── src/ # Shared UI code (React components, hooks, utilities)
│ ├── components/
│ │ ├── ui/ # shadcn primitives (button, dialog, etc.)
│ │ ├── cell/ # Notebook cell components
│ │ ├── outputs/ # Output renderers (stream, error, display data)
│ │ ├── editor/ # CodeMirror editor
│ │ └── widgets/ # ipywidgets controls
│ └── lib/
│ └── utils.ts # cn() and other utilities
├── apps/ # App entry points
│ ├── notebook/ # Notebook Tauri frontend
│ └── sidecar/ # Sidecar WebView frontend
├── crates/ # Rust code
│ ├── runt/ # CLI binary
│ ├── runtimed/ # Background daemon
│ ├── runtimed-py/ # Python bindings for the daemon
│ ├── runtimed-wasm/ # WASM Automerge bindings for frontend (same automerge crate as daemon)
│ ├── notebook/ # Notebook Tauri app
│ ├── notebook-doc/ # Shared Automerge document operations (cells, metadata, sync)
│ ├── sidecar/ # Sidecar wry/tao app
│ ├── tauri-jupyter/ # Shared Tauri/Jupyter utilities
│ ├── kernel-launch/ # Shared kernel launching API
│ ├── kernel-env/ # Environment progress reporting
│ ├── runt-trust/ # HMAC trust verification
│ ├── runt-workspace/ # Workspace detection utilities
│ └── xtask/ # Build automation tasks
├── docs/ # Architecture documentation
└── contributing/ # Developer guides
| Tool | Version | Install |
|---|---|---|
| Node.js | 20+ | https://nodejs.org |
| pnpm | 10.12+ | corepack enable |
| Rust | 1.90.0 | https://rustup.rs (version managed by rust-toolchain.toml) |
Linux only: Install GTK/WebKit dev libraries:
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev libxdo-devpnpm install
cargo xtask build| Workflow | Command | Use when |
|---|---|---|
| Hot reload | cargo xtask dev |
Iterating on React UI |
| Standalone Vite | cargo xtask vite |
Multi-window testing (Vite survives window closes) |
| Attach to Vite | cargo xtask dev --attach |
Connect Tauri to already-running Vite |
| Debug build | cargo xtask build |
Full debug build (frontend + rust) |
| Rust-only build | cargo xtask build --rust-only |
Rebuild rust, reuse existing frontend |
| Run bundled | cargo xtask run notebook.ipynb |
Run standalone binary |
| Release .app | cargo xtask build-app |
Testing app bundle locally |
| Release DMG | cargo xtask build-dmg |
Distribution (usually CI) |
The UI must be built before Rust because:
crates/sidecarembeds assets fromapps/sidecar/dist/at compile time via rust-embedcrates/notebookembeds assets fromapps/notebook/dist/via Tauri
pnpm build # Build all UIs
cargo test # Run Rust tests
pnpm test:run # Run JS tests
cargo fmt # Format Rust
npx @biomejs/biome check --fix apps/notebook/src/ e2e/ # Format JS
cargo clippy --all-targets -- -D warnings # Lint RustThe underlying Rust libraries are published to crates.io:
jupyter-protocol— Jupyter messaging protocolruntimelib— Jupyter kernel interactions over ZeroMQnbformat— Notebook parsing
See the contributing/ directory for detailed guides:
- Development workflow — build commands, dev daemon, Zed tasks
- Architecture — runtime principles, daemon, state, sync
- Protocol — wire protocol, magic bytes preamble, version negotiation
- Releasing — versioning scheme, release procedures, tag conventions
- Testing — Vitest, Rust, Python, E2E
BSD-3-Clause
