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 vaultrun_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.4.0

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.4.0
File	Size	Uploaded
vaultrun_sdk-0.4.0.tar.gz	14.6 kB	Oct 14, 2026	Details

Built distribution (wheel)

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

Total release size: 24.8 kB

Release files / vaultrun_sdk-0.4.0.tar.gz

Download URL	vaultrun_sdk-0.4.0.tar.gz
Size	14.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`288aa0c9640068926b8c96a85a09cbdaaced47964a9bcea499e34f48c9dd429c`
BLAKE2b-256 checksum How to use checksums	`2207cd296d0165227f52501331ee44df26c8cc9add4e7e0544617a6c2d7203f6`
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/8f5aa4d08e4259f7f4a7d159f5d93ada062700a9

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/8f5aa4d08e4259f7f4a7d159f5d93ada062700a9/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38638514115/attempts/1

Artifact

Subject: vaultrun_sdk-0.4.0.tar.gz
SHA-256 checksum: 288aa0c9640068926b8c96a85a09cbdaaced47964a9bcea499e34f48c9dd429c Verifying attestations

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

Download URL	vaultrun_sdk-0.4.0-py3-none-any.whl
Size	10.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7d6a0f09f083046d80a9abd3cf1af4b64c31cc24ccac2849b0cdcbfc046aa2e6`
BLAKE2b-256 checksum How to use checksums	`e94d41f116ca76de4bfeaa7f00d880fdba448b05a211fb3ffecfc38835bc64d3`
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/8f5aa4d08e4259f7f4a7d159f5d93ada062700a9

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/8f5aa4d08e4259f7f4a7d159f5d93ada062700a9/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38638514115/attempts/1

Artifact

Subject: vaultrun_sdk-0.4.0-py3-none-any.whl
SHA-256 checksum: 7d6a0f09f083046d80a9abd3cf1af4b64c31cc24ccac2849b0cdcbfc046aa2e6 Verifying attestations