Base Image
What every Sandbox session ships with out of the box, and how to add your own tools.
Every Sandbox session starts from the same prepared base image, so common
runtimes and tools are already present the moment a session reaches READY. The
essentials need no install-and-warm-up step. This page lists what ships by default and
how to add anything else.
The base is a standard Ubuntu 24.04 LTS Linux VM. You log in as the tenki user
(uid 1000) with passwordless sudo, so you can apt install, pip install, or
npm install anything not listed here.
User, home, and writable paths
Commands run as the unprivileged tenki user, never as root:
Writable as tenki, with no sudo:
/home/tenki— your home, and the default working directory/tmp— world-writable- any read-write volume you attach; the mount point is set to
tenkiownership when it is mounted
Everything outside those paths belongs to root, including /mnt, /opt, /usr, and
/var, so writing there needs sudo:
mkdir /mnt/data # Permission denied
sudo mkdir /mnt/data # works, no password promptThe same applies to anything touching system state — a bare apt-get install fails on the
dpkg lock, and sudo apt-get install is the working form:
sudo apt-get update && sudo apt-get install -y ffmpegFiles and directories written through an SDK's filesystem API are created as tenki, so
commands in the session can read and write them without any ownership fix-up.
Versions change over time
The versions below reflect the current base image and are refreshed as tools release updates. To see exactly what a live session has, run the version command for the tool (for example python3 --version or node --version) inside the session.
Language runtimes
Package managers & language tooling
Coding agents
Sandbox bakes in the major terminal coding agents so you can drive them directly inside a session:
Python data & ML libraries
Preinstalled into the system Python so data and analysis workloads run without a setup step:
Heavier deep-learning frameworks (PyTorch, TensorFlow, Transformers, and similar) are not preinstalled. They tend to be large and GPU-oriented, so it's best to pin them per workload. Install them per session or bake them into a template.
Common CLI tools
Available on PATH in every session:
- Version control & GitHub:
git,gh - HTTP & transfer:
curl,wget,rsync - Search & data:
ripgrep(rg),jq,sqlite3 - Archives:
tar,zip/unzip,zstd,bzip2,xz - Build:
build-essential(gcc/make),pkg-config - SSH:
openssh-client,openssh-server - Inspect:
file,less,lsof
Checking what's installed
Because you have sudo, you can inspect anything from inside a session:
python3 --version
node --version
claude --version
python3 -c "import numpy, pandas, sklearn; print(numpy.__version__, pandas.__version__)"
dpkg -l | grep -i ripgrepAdding your own tools
For a one-off session, just install what you need:
pip install polars
sudo apt-get update && sudo apt-get install -y ffmpeg
npm install -g some-cliIf every session should start with the same extra tools, define them once in a template instead of installing on each session — the template build captures the prepared environment as a snapshot so new sessions start ready.
Pre-built images
The standard sandbox image is the default. We also publish pre-built images that
layer one focused integration onto that same base, so you do not have to build it yourself.
Start a session from one with luxor sandbox create --image <ref>.
Anchor adds playwright-core for connecting to an Anchor-managed
browser, without adding a local browser or credentials.
Grok pins xAI's Grok Build coding agent, ready for a non-interactive
grok -p with an XAI_API_KEY or a device-code login.
Droid adds Factory's Droid coding agent, pinned and ready for a
non-interactive droid exec with a FACTORY_API_KEY.
Pi pins the open source Pi coding agent, ready for a non-interactive
pi -p with any supported provider key.
Amp pins Sourcegraph's Amp coding agent, ready for a non-interactive
amp -x with an AMP_API_KEY or an Amp login.
Prime Agent pins Prime Intellect's Prime Agent coding and
research harness, with its Python kernel prewarmed, ready for a non-interactive prime-agent -p
with a PRIME_API_KEY or a Prime Intellect login.
TinyFish adds the TinyFish CLI, TypeScript SDK, and playwright-core
for TinyFish's web agent, remote browser, fetch, and search APIs, with a TINYFISH_API_KEY.
Hotdata adds the Hotdata CLI, Python SDK, and agent skill, ready to create
Hotdata databases, load files into them, and query them with SQL using a HOTDATA_API_KEY.
Need a package added to the base?
If you think a tool or library is broadly useful enough to belong in the default base image, let us know. We keep the base intentionally lean, but the included package set evolves based on what customers reach for most.