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

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.1
File	Size	Uploaded
vaultrun_sdk-0.4.1.tar.gz	14.6 kB	Oct 15, 2026	Details

Built distribution (wheel)

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

Total release size: 24.8 kB

Release files / vaultrun_sdk-0.4.1.tar.gz

Download URL	vaultrun_sdk-0.4.1.tar.gz
Size	14.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`03aa9e2313fcdef7f1c7474e2536998dbe3c4dd7b7e1a8ae2f3549dbe25ee2fe`
BLAKE2b-256 checksum How to use checksums	`d31bbdeb4eda7a77298213404a8e9043ec95a44203b3e4a12f2a3a904548e4c0`
Upload date	Oct 15, 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/2520c33716135cb8f79c1e62cb232d0452cbc06d

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/2520c33716135cb8f79c1e62cb232d0452cbc06d/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38757116007/attempts/1

Artifact

Subject: vaultrun_sdk-0.4.1.tar.gz
SHA-256 checksum: 03aa9e2313fcdef7f1c7474e2536998dbe3c4dd7b7e1a8ae2f3549dbe25ee2fe Verifying attestations

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

Download URL	vaultrun_sdk-0.4.1-py3-none-any.whl
Size	10.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8694f35b8a726cae5aeab2e9223f971e09748ed048edff507bcf4d7705acd514`
BLAKE2b-256 checksum How to use checksums	`bf16c88fb59baa6911c1594fcd9ab595d418f451aed378d8c4a9343cc76a5d5d`
Upload date	Oct 15, 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/2520c33716135cb8f79c1e62cb232d0452cbc06d

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/2520c33716135cb8f79c1e62cb232d0452cbc06d/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38757116007/attempts/1

Artifact

Subject: vaultrun_sdk-0.4.1-py3-none-any.whl
SHA-256 checksum: 8694f35b8a726cae5aeab2e9223f971e09748ed048edff507bcf4d7705acd514 Verifying attestations