`Vpod` Python SDK

A lightweight, portable sandbox that gives an untrusted process an instant Linux environment.

It uses a RISC‑V architecture and runs entirely inside WebAssembly.

Fast startup : Boot in under a second.
Portable : Runs anywhere without any setup required.
Isolated : All execution state stays inside the WASM sandbox.

Installation

pip install vpod

Usage

Persistent session (Recommended)

All calls share the same running sandbox. Using a context manager (with) automatically cleans up resources when done:

from vpod import Sandbox

with Sandbox.create() as sbx:
    sbx.commands.run("export FOO=bar")
    sbx.commands.run("touch /tmp/data.csv")

    result = sbx.commands.run("echo $FOO")
    print(result.stdout)  # bar

Python REPL

Run Python code with persistent state across calls. Variables and imports persist for the lifetime of the session.

from vpod import Sandbox

with Sandbox.create() as sbx:
    sbx.code.run("import requests")
    sbx.code.run("data = [1, 2, 3]")
    result = sbx.code.run("print(sum(data))")
    print(result.text)  # 6

Advanced Configuration

You can mount local directories into the sandbox and specify which snapshot to use.

from vpod import Sandbox

# Mount a local workspace and use a snapshot with pre-installed data science tools
mounts = {"workspace": "/workspace:rw"}

with Sandbox.create(snapshot="vsnap-data", mounts=mounts) as sbx:
    sbx.code.run("import pandas as pd")
    sbx.code.run("print('Pandas is ready!')")

Suspend & Resume

Pause a running sandbox and resume it later — no daemon, no background process. Only dirty memory pages are saved, making it fast and storage-efficient.

from vpod import Sandbox

with Sandbox.create() as sbx:
    sbx.commands.run("uv pip install --system requests")
    instance_id = sbx.suspend()

# Later (even from a new process):
sbx = Sandbox.resume(instance_id)
sbx.code.run("import requests; print(requests.__version__)")

Method	Description
`sandbox.suspend()`	Suspend to disk, returns instance ID
`Sandbox.resume(id)`	Resume a suspended instance
`Sandbox.list_instances()`	List all instances
`Sandbox.destroy(id)`	Delete a suspended instance from disk

Shell commands (stateless)

If you just need a quick one-off execution without preserving state:

from vpod import Sandbox

sbx = Sandbox.create()
result = sbx.commands.run("echo hello")
print(result.stdout)    # hello
sbx.close()             # Clean up the sandbox process

Snapshots

The first call to Sandbox.create() downloads the snapshot and caches it locally. Subsequent calls use the cache instantly.

To pre-download (e.g. in a Dockerfile or CI setup):

from vpod import snapshots

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

snapshots.pull("alpine:latest")

Available Snapshots

Name	Tag	Description	Memory Limit (RAM)
`alpine`	3.23.0	Minimal Alpine Linux snapshot.	256 MB
`vsnap-base`	0.1.0	Alpine-based general-purpose snapshot with Python.	256 MB
`vsnap-base-512mb`	0.1.0	Same as `vsnap-base` with more memory headroom, for web servers and larger installs.	512 MB
`vsnap-data`	0.1.0	Alpine-based snapshot with `numpy`, `pandas`, and `scipy`.	512 MB

Documentation

Visit the Vpod documentation for the full guide and API reference. To report issues or contribute, head to the main GitHub repository.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vpod-0.7.2.tar.gz (6.0 MB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vpod-0.7.2-py3-none-any.whl (6.0 MB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file vpod-0.7.2.tar.gz.

File metadata

Download URL: vpod-0.7.2.tar.gz
Upload date: Aug 19, 2026
Size: 6.0 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.10.20

File hashes

Hashes for vpod-0.7.2.tar.gz
Algorithm	Hash digest
SHA256	`05ce45579e61d4b61958df8541f9a08b5af031806530e8f74a5c37c389233314`
MD5	`3d40eaac55210e8f3f92d62d23ebbc40`
BLAKE2b-256	`4c3833cb5a0921d6a1d93df9f85e02c3fab26084175df44fca339cff33eeef21`

See more details on using hashes here.

File details

Details for the file vpod-0.7.2-py3-none-any.whl.

File metadata

Download URL: vpod-0.7.2-py3-none-any.whl
Upload date: Aug 19, 2026
Size: 6.0 MB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.10.20

File hashes

Hashes for vpod-0.7.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d2aa4ab637984c07ad5cefe087041d48d0127966dc6ce68e6a01375d0a4e6fec`
MD5	`55cb5751686ff7532fe723b8e9e51c2f`
BLAKE2b-256	`e5e71b34fcab72de75b2df7574458fb0273fbf7fca8f0a7b8a7a58312a0bf931`