Skip to main content

praisonai-sandbox

Isolated agent code execution for PraisonAI — Docker, subprocess, E2B, Modal, Novita, Sandlock, and SSH backends.

Install

pip install praisonai-sandbox[docker]

Usage

from praisonai_sandbox import DockerSandbox
from praisonaiagents.sandbox import SandboxConfig

config = SandboxConfig.docker("python:3.11-slim")
sandbox = DockerSandbox(image=config.image, config=config)

Or via the agents manager:

from praisonaiagents.sandbox import SandboxManager, SandboxConfig

manager = SandboxManager(SandboxConfig.subprocess())
result = await manager.run_code("print('hello')")

Console script

praisonai-sandbox --help

Backward-compatible imports via the umbrella package:

from praisonai.sandbox import SubprocessSandbox  # shim → praisonai_sandbox

Validating your install

Note: The e2e-validation/ bundle and tests/ ship with the source repository, not the published wheel. Run these commands from a checkout of this repo (src/praisonai-sandbox/), not from a pip installed environment.

Run the single-command end-to-end smoke suite (no API keys needed for the subprocess path; Docker is optional and skipped when unavailable):

python e2e-validation/run_e2e.py

Or use the pytest live probes:

python -m pytest tests/test_live_sandbox.py -v

See e2e-validation/ for the manual guide.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

praisonai_sandbox-0.0.12.tar.gz (42.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

praisonai_sandbox-0.0.12-py3-none-any.whl (39.0 kB view details)

Uploaded Python 3

File details

Details for the file praisonai_sandbox-0.0.12.tar.gz.

File metadata

  • Download URL: praisonai_sandbox-0.0.12.tar.gz
  • Upload date:
  • Size: 42.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for praisonai_sandbox-0.0.12.tar.gz
Algorithm Hash digest
SHA256 41005bc3de98cd33957262c4d64b005fe3a5684a2733e56bdbc04954c2d9586f
MD5 e01cab9cf5092d779e377d5994733373
BLAKE2b-256 30a64efc3290df9cf6ee3c8a88e4fb3e0680a3fd113839aba36464908afadbf7

See more details on using hashes here.

File details

Details for the file praisonai_sandbox-0.0.12-py3-none-any.whl.

File metadata

  • Download URL: praisonai_sandbox-0.0.12-py3-none-any.whl
  • Upload date:
  • Size: 39.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for praisonai_sandbox-0.0.12-py3-none-any.whl
Algorithm Hash digest
SHA256 1a3dbc33b9a2b3a90f210bc4bacb9816b8b03f02e12eb6d91ee283ba63a3ee41
MD5 ff9e30c6cd07b46d6b38c3002f9833d1
BLAKE2b-256 e23ca8367ac118614c7f86e4f81ff0f90906f714b8c2044b8fbf75af2c717e60

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.13

2 files

This release

0.0.12 This release

2 files

0.0.11

2 files

0.0.10

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page