vaultrun-sdk

Python SDK for VaultRun — the self-hosted secure runtime for AI agents.

VaultRun lets AI agents safely execute code, query databases, call cloud APIs, and manage files inside isolated Docker sandboxes running on your own infrastructure. This package is the typed Python client for the VaultRun REST API.

Install

pip install vaultrun-sdk

Quickstart

from sandbox_sdk import Client

client = Client("http://localhost:8080", api_key="vr_...")

session = client.create_session(image="python:3.12-slim", memory_limit_mb=256)
client.upload_file(session.id, "script.py", open("script.py", "rb"))

result = client.run(session.id, command="python", args=["script.py"])
print(result.stdout)

client.delete_session(session.id)

Features

Sessions: create, list, get, delete isolated sandbox sessions
Runs: execute commands, stream output, fetch run details and logs
Files: upload, list, and download workspace files
Keys, organizations, audit logs, snapshots, artifacts, images, and session stats

Requirements

Python 3.10+
A running VaultRun instance and an API key (vr_...)

License

Apache 2.0

Metadata

Release files for vaultrun-sdk 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vaultrun-sdk 0.3.3
File	Size	Uploaded
vaultrun_sdk-0.3.3.tar.gz	14.0 kB	Oct 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vaultrun-sdk 0.3.3
File	Interpreter	ABI	Platform	Reset
vaultrun_sdk-0.3.3-py3-none-any.whl 9.6 kB Oct 14, 2026	Python 3	none	any	Details

Total release size: 23.6 kB

Release files / vaultrun_sdk-0.3.3.tar.gz

Download URL	vaultrun_sdk-0.3.3.tar.gz
Size	14.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`5de00ea2c28ef3db0b629ba6b140498bcf82f407ce342a831b2f212ecaa46fa8`
BLAKE2b-256 checksum How to use checksums	`7dac1f64e2055261f43906c828eab3b655501debbf634ada3054eae0ae9a4dcb`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nickvd7/vaultrun
Publishing commit: github.com/nickvd7/vaultrun/tree/13a44bb3d4547de71aa0f541b66fa9f8a1fb6da4

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/13a44bb3d4547de71aa0f541b66fa9f8a1fb6da4/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38569126218/attempts/1

Artifact

Subject: vaultrun_sdk-0.3.3.tar.gz
SHA-256 checksum: 5de00ea2c28ef3db0b629ba6b140498bcf82f407ce342a831b2f212ecaa46fa8 Verifying attestations

Release files / vaultrun_sdk-0.3.3-py3-none-any.whl

Download URL	vaultrun_sdk-0.3.3-py3-none-any.whl
Size	9.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`47572f890c777f86af7b4dd2b88398e89f9bbb1084337e14fd8c92d47cfc402e`
BLAKE2b-256 checksum How to use checksums	`94dd77070c31649ade49a068224dfa4037aed8b46b2453033768cef1e2150b57`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nickvd7/vaultrun
Publishing commit: github.com/nickvd7/vaultrun/tree/13a44bb3d4547de71aa0f541b66fa9f8a1fb6da4

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/13a44bb3d4547de71aa0f541b66fa9f8a1fb6da4/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38569126218/attempts/1

Artifact

Subject: vaultrun_sdk-0.3.3-py3-none-any.whl
SHA-256 checksum: 47572f890c777f86af7b4dd2b88398e89f9bbb1084337e14fd8c92d47cfc402e Verifying attestations