CLI
Install
curl -fsSL https://install.vpod.sh | sh
irm https://install.vpod.sh | iex
Start a shell
# Pull a snapshot
vpod pull alpine:latest
# Start an interactive shell
vpod
Python SDK
Install
Run your first sandbox
from vpod import Sandbox
# Run a command
sandbox = Sandbox.create()
result = sandbox.commands.run("whoami")
print(result.stdout) # root
sandbox.close()
The first call to Sandbox.create() downloads the default snapshot (alpine) and caches it locally if not already present.
Persistent sessions
State is preserved across calls within the same sandbox:
# Shell session — env vars persist
with Sandbox.create() as sandbox:
sandbox.commands.run("export API_KEY=secret")
result = sandbox.commands.run("echo $API_KEY")
print(result.stdout) # secret
# Python REPL — variables persist
with Sandbox.create() as sandbox:
sandbox.code.run("import requests")
sandbox.code.run("data = [1, 2, 3]")
result = sandbox.code.run("print(sum(data))")
print(result.text) # 6
Next steps
Sandbox API
Full reference for the Sandbox class and its parameters.
Snapshots
Available snapshots and the snapshot API.
Suspend & resume
Pause a sandbox to disk and pick it up later.
CLI reference
All CLI commands and options.
