Installation

Python package

Install ipybox using pip:

pip install ipybox

or uv:

uv add ipybox

MCP server

ipybox can also be run as an MCP server using uvx:

uvx ipybox --workspace /path/to/workspace

See the MCP server documentation for configuration details.

sandbox-runtime

To use ipybox's sandboxing features, you need to install Anthropic's sandbox-runtime separately. This provides the srt command for IPython kernel and MCP server isolation.

Install via npm:

npm install -g @anthropic-ai/sandbox-runtime@0.0.19

Mac OS

On Mac OS, sandbox-runtime requires ripgrep. Install it using Homebrew:

brew install ripgrep

No other dependencies are needed on Mac OS, as sandbox-runtime uses the native sandbox-exec command for sandboxing.

Linux

On Linux, install the required system packages:

apt-get install bubblewrap socat ripgrep

Info

Sandboxing with srt currently doesn't work with ipybox on Linux, a fix is work in progress. You can still use ipybox on Linux with sandbox=False, or run the ipybox MCP server as a Docker container.