vaultrun-sdk 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. vaultrun_sdk-0.2.0/PKG-INFO +77 -0
  2. vaultrun_sdk-0.2.0/README.md +51 -0
  3. vaultrun_sdk-0.2.0/pyproject.toml +37 -0
  4. vaultrun_sdk-0.2.0/sandbox_sdk/__init__.py +42 -0
  5. vaultrun_sdk-0.2.0/sandbox_sdk/client.py +902 -0
  6. vaultrun_sdk-0.2.0/setup.cfg +4 -0
  7. vaultrun_sdk-0.2.0/tests/test_client.py +783 -0
  8. vaultrun_sdk-0.2.0/vaultrun_sdk.egg-info/PKG-INFO +77 -0
  9. vaultrun_sdk-0.2.0/vaultrun_sdk.egg-info/SOURCES.txt +10 -0
  10. vaultrun_sdk-0.2.0/vaultrun_sdk.egg-info/dependency_links.txt +1 -0
  11. vaultrun_sdk-0.2.0/vaultrun_sdk.egg-info/requires.txt +5 -0
  12. vaultrun_sdk-0.2.0/vaultrun_sdk.egg-info/top_level.txt +1 -0
vaultrun_sdk-0.2.0/PKG-INFO ADDED
@@ -0,0 +1,77 @@
1
+ Metadata-Version: 2.4
2
+ Name: vaultrun-sdk
3
+ Version: 0.2.0
4
+ Summary: Python SDK for the VaultRun secure AI agent sandbox runtime
5
+ License: Apache-2.0
6
+ Project-URL: Homepage, https://vaultrun.dev
7
+ Project-URL: Repository, https://github.com/nickvd7/vaultrun
8
+ Project-URL: Issues, https://github.com/nickvd7/vaultrun/issues
9
+ Project-URL: Changelog, https://github.com/nickvd7/vaultrun/blob/main/CHANGELOG.md
10
+ Keywords: ai-agents,sandbox,mcp,docker,security,self-hosted
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: Apache Software License
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
19
+ Classifier: Topic :: Security
20
+ Requires-Python: >=3.10
21
+ Description-Content-Type: text/markdown
22
+ Requires-Dist: requests>=2.31.0
23
+ Provides-Extra: dev
24
+ Requires-Dist: pytest>=8; extra == "dev"
25
+ Requires-Dist: responses>=0.25; extra == "dev"
26
+
27
+ # vaultrun-sdk
28
+
29
+ Python SDK for [VaultRun](https://vaultrun.dev) — the self-hosted secure runtime for AI agents.
30
+
31
+ VaultRun lets AI agents safely execute code, query databases, call cloud APIs, and manage
32
+ files inside isolated Docker sandboxes running on your own infrastructure. This package is
33
+ the typed Python client for the VaultRun REST API.
34
+
35
+ ## Install
36
+
37
+ ```bash
38
+ pip install vaultrun-sdk
39
+ ```
40
+
41
+ ## Quickstart
42
+
43
+ ```python
44
+ from sandbox_sdk import Client
45
+
46
+ client = Client("http://localhost:8080", api_key="vr_...")
47
+
48
+ session = client.create_session(image="python:3.12-slim", memory_limit_mb=256)
49
+ client.upload_file(session.id, "script.py", open("script.py", "rb"))
50
+
51
+ result = client.run(session.id, command="python", args=["script.py"])
52
+ print(result.stdout)
53
+
54
+ client.delete_session(session.id)
55
+ ```
56
+
57
+ ## Features
58
+
59
+ - Sessions: create, list, get, delete isolated sandbox sessions
60
+ - Runs: execute commands, stream output, fetch run details and logs
61
+ - Files: upload, list, and download workspace files
62
+ - Keys, organizations, audit logs, snapshots, artifacts, images, and session stats
63
+
64
+ ## Requirements
65
+
66
+ - Python 3.10+
67
+ - A running [VaultRun](https://github.com/nickvd7/vaultrun) instance and an API key (`vr_...`)
68
+
69
+ ## Links
70
+
71
+ - Website: https://vaultrun.dev
72
+ - Source & docs: https://github.com/nickvd7/vaultrun
73
+ - Issues: https://github.com/nickvd7/vaultrun/issues
74
+
75
+ ## License
76
+
77
+ Apache 2.0
vaultrun_sdk-0.2.0/README.md ADDED
@@ -0,0 +1,51 @@
1
+ # vaultrun-sdk
2
+
3
+ Python SDK for [VaultRun](https://vaultrun.dev) — the self-hosted secure runtime for AI agents.
4
+
5
+ VaultRun lets AI agents safely execute code, query databases, call cloud APIs, and manage
6
+ files inside isolated Docker sandboxes running on your own infrastructure. This package is
7
+ the typed Python client for the VaultRun REST API.
8
+
9
+ ## Install
10
+
11
+ ```bash
12
+ pip install vaultrun-sdk
13
+ ```
14
+
15
+ ## Quickstart
16
+
17
+ ```python
18
+ from sandbox_sdk import Client
19
+
20
+ client = Client("http://localhost:8080", api_key="vr_...")
21
+
22
+ session = client.create_session(image="python:3.12-slim", memory_limit_mb=256)
23
+ client.upload_file(session.id, "script.py", open("script.py", "rb"))
24
+
25
+ result = client.run(session.id, command="python", args=["script.py"])
26
+ print(result.stdout)
27
+
28
+ client.delete_session(session.id)
29
+ ```
30
+
31
+ ## Features
32
+
33
+ - Sessions: create, list, get, delete isolated sandbox sessions
34
+ - Runs: execute commands, stream output, fetch run details and logs
35
+ - Files: upload, list, and download workspace files
36
+ - Keys, organizations, audit logs, snapshots, artifacts, images, and session stats
37
+
38
+ ## Requirements
39
+
40
+ - Python 3.10+
41
+ - A running [VaultRun](https://github.com/nickvd7/vaultrun) instance and an API key (`vr_...`)
42
+
43
+ ## Links
44
+
45
+ - Website: https://vaultrun.dev
46
+ - Source & docs: https://github.com/nickvd7/vaultrun
47
+ - Issues: https://github.com/nickvd7/vaultrun/issues
48
+
49
+ ## License
50
+
51
+ Apache 2.0
vaultrun_sdk-0.2.0/pyproject.toml ADDED
@@ -0,0 +1,37 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "vaultrun-sdk"
7
+ version = "0.2.0"
8
+ description = "Python SDK for the VaultRun secure AI agent sandbox runtime"
9
+ readme = "README.md"
10
+ license = { text = "Apache-2.0" }
11
+ requires-python = ">=3.10"
12
+ dependencies = ["requests>=2.31.0"]
13
+ classifiers = [
14
+ "Development Status :: 4 - Beta",
15
+ "Intended Audience :: Developers",
16
+ "License :: OSI Approved :: Apache Software License",
17
+ "Programming Language :: Python :: 3",
18
+ "Programming Language :: Python :: 3.10",
19
+ "Programming Language :: Python :: 3.11",
20
+ "Programming Language :: Python :: 3.12",
21
+ "Topic :: Software Development :: Libraries :: Python Modules",
22
+ "Topic :: Security",
23
+ ]
24
+ keywords = ["ai-agents", "sandbox", "mcp", "docker", "security", "self-hosted"]
25
+
26
+ [project.urls]
27
+ Homepage = "https://vaultrun.dev"
28
+ Repository = "https://github.com/nickvd7/vaultrun"
29
+ Issues = "https://github.com/nickvd7/vaultrun/issues"
30
+ Changelog = "https://github.com/nickvd7/vaultrun/blob/main/CHANGELOG.md"
31
+
32
+ [project.optional-dependencies]
33
+ dev = ["pytest>=8", "responses>=0.25"]
34
+
35
+ [tool.setuptools.packages.find]
36
+ where = ["."]
37
+ include = ["sandbox_sdk*"]
vaultrun_sdk-0.2.0/sandbox_sdk/__init__.py ADDED
@@ -0,0 +1,42 @@
1
+ """VaultRun Python SDK — secure sandbox runtime for AI agents."""
2
+
3
+ from .client import (
4
+ Client,
5
+ Session,
6
+ Run,
7
+ AsyncRunResult,
8
+ File,
9
+ APIKey,
10
+ CreatedKey,
11
+ AuditLog,
12
+ StreamResult,
13
+ Organization,
14
+ OrgMember,
15
+ Snapshot,
16
+ SharedArtifact,
17
+ Image,
18
+ SessionStats,
19
+ PullStatus,
20
+ VaultRunError,
21
+ )
22
+
23
+ __all__ = [
24
+ "Client",
25
+ "Session",
26
+ "Run",
27
+ "AsyncRunResult",
28
+ "File",
29
+ "APIKey",
30
+ "CreatedKey",
31
+ "AuditLog",
32
+ "StreamResult",
33
+ "Organization",
34
+ "OrgMember",
35
+ "Snapshot",
36
+ "SharedArtifact",
37
+ "Image",
38
+ "SessionStats",
39
+ "PullStatus",
40
+ "VaultRunError",
41
+ ]
42
+ __version__ = "0.1.0"