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.3.4

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

Built distribution (wheel)

Table of built distributions (wheels) for vaultrun-sdk 0.3.4
File	Interpreter	ABI	Platform	Reset
vaultrun_sdk-0.3.4-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.3.4.tar.gz

Download URL	vaultrun_sdk-0.3.4.tar.gz
Size	14.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`7939dc4e6a097e7613486cba075d30ead314f9b4da115c0da4dc8d03ab72cce0`
BLAKE2b-256 checksum How to use checksums	`e5123f8811f7f4a5bdd2d7b03d199c2a85710c4d544b5a58f55f50cd77cef335`
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/08f3655d34baf285ef5281f828ffc03d987761c3

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/08f3655d34baf285ef5281f828ffc03d987761c3/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38635194385/attempts/1

Artifact

Subject: vaultrun_sdk-0.3.4.tar.gz
SHA-256 checksum: 7939dc4e6a097e7613486cba075d30ead314f9b4da115c0da4dc8d03ab72cce0 Verifying attestations

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

Download URL	vaultrun_sdk-0.3.4-py3-none-any.whl
Size	10.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1f84c0647635e385554fbd0bfeb31380b96bfad4fccdce8879e53c373f859cda`
BLAKE2b-256 checksum How to use checksums	`178d52952a47f748c0c75a00d945582ec967376b958df475a5759fe96a06e7de`
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/08f3655d34baf285ef5281f828ffc03d987761c3

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/08f3655d34baf285ef5281f828ffc03d987761c3/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38635194385/attempts/1

Artifact

Subject: vaultrun_sdk-0.3.4-py3-none-any.whl
SHA-256 checksum: 1f84c0647635e385554fbd0bfeb31380b96bfad4fccdce8879e53c373f859cda Verifying attestations