Snapshots

A snapshot is a saved state that a sandbox boots from. Because the environment (OS, libraries) is already set up inside the snapshot, booting skips installation entirely. Each snapshot ships with a matching ahead-of-time translation module. If the bundled module doesn’t match the snapshot, the SDK prints a warning — the sandbox still works, but runs at interpreter speed.

Available snapshots

Name	Tag	Description	Memory limit (RAM)
`alpine`	3.23.0	Minimal Alpine Linux snapshot	256 MB
`vsnap-base`	1.0.0	Alpine-based snapshot with Python pre-installed	256 MB
`vsnap-base-512mb`	1.0.0	Same contents as `vsnap-base` with a larger memory limit	512 MB
`vsnap-data`	1.0.0	Alpine-based snapshot with `numpy`, `pandas`, and `scipy` pre‑installed	512 MB

uv comes preinstalled in every snapshot, so additional Python packages can be installed with uv pip install --system <package>. System packages remain available through Alpine’s package manager with apk add <package>.

from vpod import Sandbox

with Sandbox.create(snapshot="vsnap-data") as sandbox:
    sandbox.code.run("import pandas as pd; import numpy as np")
    r = sandbox.code.run("s = pd.Series([1, 2, 3, 4, 5]); print(s.sum(), s.mean())")
    print(r.text)

Snapshot API

Method	Description	Return type
`snapshots.catalog()`	Fetch available snapshots	`list[dict]`
`snapshots.pull(name)`	Pull a snapshot	`str`

from vpod import snapshots

for snap in snapshots.catalog():
    print(snap["name"], snap["tag"])

snapshots.pull("vsnap-data")

Get Started

TypeScript SDK

Python SDK

CLI

Resources

Available snapshots

Snapshot API

​Available snapshots

​Snapshot API

Available snapshots

Snapshot API