Repository navigation
Download
This release supports macOS 15 or later on Apple silicon, ARM64 Linux, and x86-64 Linux. Download Box Core into a local directory:
curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh | shPin this exact release:
curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh | BOX_VERSION=v0.2.4 shThe downloader picks the archive for your platform from the assets below, verifies it against SHA256SUMS.txt, and unpacks its files into ./box-core. Nothing is installed: your $PATH and system directories are untouched. Override the directory with BOX_DOWNLOAD_DIR=/some/path. Write a box.toml and a policy, then run the box by path (./box-core/box run --config ./box.toml).
Linux
The Linux builds require glibc 2.34 or newer, libgcc, and a host that permits Box's namespace, mount, and syscall-filter setup. Package availability does not establish security acceptance.
Manual Linux ARM64 install
To install without the downloader, download box-v0.2.4-linux-arm64.tar.gz and SHA256SUMS.txt from the assets below. In the download directory, run:
awk '$2 == "box-v0.2.4-linux-arm64.tar.gz"' SHA256SUMS.txt > box-linux.sha256 &&
test -s box-linux.sha256 &&
sha256sum --check box-linux.sha256 &&
mkdir -p box-core &&
tar -C box-core -xzf box-v0.2.4-linux-arm64.tar.gz &&
./box-core/box run --config ./box.tomlLinux x86-64
For Amazon Linux 2023 x86-64, use box-v0.2.4-linux-x86_64.tar.gz. The downloader selects this archive and verifies its checksum. Download this exact release, then start a workload:
curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh -o download-box.sh &&
BOX_VERSION=v0.2.4 sh download-box.sh &&
./box-core/box run --config ./box.tomlAssets
The macOS archive contains Box.app, a box launcher, and helper links into its signed and notarized bundle. Keep that directory intact. Linux archives contain box beside its helpers. SHA256SUMS.txt contains each archive's checksum.