Install nteract

macOS (Apple silicon or Intel), Windows, and Linux. The app bundles everything: the notebook, the runt CLI, and the runtimed daemon, kept up to date automatically.

curl -fsSL https://sh.nteract.io | bash

Installs the app (the AppImage on Linux; the signed bundle in ~/Applications on macOS) plus runt, runtimed, and nteract-mcp, links the commands into ~/.local/bin, and sets up the per-user daemon service (systemd on Linux, launchd on macOS). Everything is per-user — no root, no system package manager. Re-run the same command to upgrade.

For machines that only run compute — an Outerbounds workstation, a JupyterHub single-user server, a beefy box under your desk — skip the desktop app:

curl -fsSL https://sh.nteract.io | bash -s -- --headless

To offer that machine’s compute to a hosted notebook, open the notebook’s workstation panel, choose Add workstation to mint a pairing code, and run the two commands it shows you:

runt workstation connect https://app.runt.run --code XXXX-XXXX-XXXX
runt workstation run

The machine appears in the panel by name and serves execution over an outbound connection — no inbound ports, no reverse proxy. Workstation pairing ships with the next stable release; the nightly channel has it first.

Stable is the default everywhere above. The nightly channel installs side-by-side with channel-suffixed commands (runt-nightly, nteract-nightly), so you can run both. Agents have their own setup — see nteract for agents.