> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vpod.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapshots

> Available snapshots and the snapshot API.

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.

## 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-data` | 1.0.0  | Alpine-based snapshot with `numpy`, `pandas`, and `scipy` pre‑installed | 512 MB             |

```python theme={null}
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`        |

```python theme={null}
from vpod import snapshots

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

snapshots.pull("vsnap-data")
```