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

Built distribution (wheel)

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

Download URL	vaultrun_sdk-0.4.3.tar.gz
Size	14.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`40bae572ed9a5dd5fd996a4433c7a9be66bd64a5580bb48cc64e94f76ed40fc0`
BLAKE2b-256 checksum How to use checksums	`3e205b5be94717218b5d50e4bd8396ecf72237aa15a61e5d5f70e0e43cc5f19a`
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/16641317cdc1ab3604d60ed7b4b0f332622d4fa2

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/16641317cdc1ab3604d60ed7b4b0f332622d4fa2/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38812021438/attempts/1

Artifact

Subject: vaultrun_sdk-0.4.3.tar.gz
SHA-256 checksum: 40bae572ed9a5dd5fd996a4433c7a9be66bd64a5580bb48cc64e94f76ed40fc0 Verifying attestations

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

Download URL	vaultrun_sdk-0.4.3-py3-none-any.whl
Size	10.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`61c00e5997e8446b490eb3e03a18498de4351424a9b82c628e00264e1c483506`
BLAKE2b-256 checksum How to use checksums	`16e47fca2c3d10a2602cb9f7c75f169f44546a0ba25d49e22a12a226d8d072e0`
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/16641317cdc1ab3604d60ed7b4b0f332622d4fa2

Workflow

Publishing configuration: github.com/nickvd7/vaultrun/blob/16641317cdc1ab3604d60ed7b4b0f332622d4fa2/.github/workflows/pypi.yml
Publishing logs: github.com/nickvd7/vaultrun/actions/runs/38812021438/attempts/1

Artifact

Subject: vaultrun_sdk-0.4.3-py3-none-any.whl
SHA-256 checksum: 61c00e5997e8446b490eb3e03a18498de4351424a9b82c628e00264e1c483506 Verifying attestations