Skip to main content
Hyperbrowser currently ships three built-in sandbox base images:
  • node
  • python
  • node-chromium
Use these imageName values directly when you create a sandbox.

Quick Start

const sandbox = await client.sandboxes.create({
  imageName: "node",
});

Available Images

imageNameBest forIncludes
nodeGeneral Node.js and TypeScript workloadsUbuntu 24.04, Node.js, /home/ubuntu working directory
pythonPython scripts, agents, and data workloadsUbuntu 24.04, Python 3, pip, venv
node-chromiumBrowser automation, desktop-style flows, and Playwright Chromium workloadsNode.js, Playwright Chromium, desktop session tooling

Runtime Defaults

All current base images share a few defaults:
  • Ubuntu 24.04 as the base OS.
  • A default ubuntu user with home directory at /home/ubuntu.
  • Default working directory set to /home/ubuntu.
  • A writable app directory at /usr/src/app.
  • Sandbox filesystem APIs enabled for the standard writable roots.

Which Image To Choose

Choose node when you want a minimal JavaScript or TypeScript runtime. Choose python when your workload is Python-first and you want pip and venv ready out of the box. Choose node-chromium when you need a browser-capable image with Chromium already installed and want the best starting point for browser automation or desktop-style workflows.

Next Steps