Base images

Every template starts from one base image. Select it first, then add packages, files, and commands.

AgentBox base image

fromBaseImage() uses the AgentBox OCI image as its base. It is a practical default for development and automation workloads.

The image includes:

• Python 3.11 with pip, uv, and uvx;
• Node.js 24 with npm, npx, and yarn;
• Git, Git LFS, OpenSSH, GitHub CLI (gh), and GitLab CLI (glab);
• the rg, fd, find, grep, sed, gawk, diff, patch, jq, and yq search and text-processing tools;
• the curl, wget, and rsync download and synchronization tools;
• the tar, gzip, bzip2, xz, zip, unzip, and zstd archive tools;
• the ss, dig, nc, bash, coreutils, util-linux, procps, file, and less networking and system utilities;
• a C/C++ compiler, pkg-config, and headers for building common dependencies.

The user account has /home/user as its home directory and can run commands through passwordless sudo.

Common OCI images

The SDK provides helpers for common images: fromUbuntuImage, fromDebianImage, fromFedoraImage, fromAlpineImage, fromArchImage, fromPythonImage, fromNodeImage, and fromBunImage.

For example:

• fromUbuntuImage("24.04") selects ubuntu:24.04;
• fromNodeImage("24-bookworm-slim") selects node:24-bookworm-slim;
• fromBunImage("1.3") selects oven/bun:1.3.

These are OCI images from a Docker Registry. AgentBox uses their filesystem as the template foundation, but runs the sandbox in a virtual machine rather than in a Docker container.

Any OCI image

fromImage("registry.example.com/team/app:1.4.0") accepts a complete OCI image reference. For a private registry, supply its credentials.

A definition can select only one base. Use fromTemplate("name:tag") to extend one of your existing templates.