Base Images

​

Quick Start

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

sandbox = client.sandboxes.create(
    {
        "image_name": "python",
    }
)

from hyperbrowser.models import CreateSandboxParams

sandbox = client.sandboxes.create(
    CreateSandboxParams(
        image_name="python",
    )
)

curl -X POST https://api.hyperbrowser.ai/api/sandbox \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageName": "node"
  }'

​

Available Images

​

Runtime Defaults

• Ubuntu 24.04 as the base OS.
• A default ubuntu sudo user with home directory at /home/ubuntu.
• Default working directory set to /home/ubuntu.

​

Which Image To Choose

• Choose node when you want a minimal JavaScript or TypeScript runtime.
• Choose openclaw when you want a Node runtime with the OpenClaw CLI preinstalled.
• Choose claude-code when you want a Node runtime with the Claude Code CLI preinstalled.
• Choose codex when you want a Node runtime with the Codex CLI preinstalled.
• 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

• For launch parameters and runtime options, continue to Creating Sandboxes.
• To package your own Docker image into a sandbox image, see Build And Upload A Custom Image.