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.12-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.1.0.tar.gz (74.3 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.1.0-py3-none-any.whl (74.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: praisonai_sandbox-0.1.0.tar.gz
  • Upload date:
  • Size: 74.3 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.1.0.tar.gz
Algorithm Hash digest
SHA256 286af6b8242b8284996b980f4e520722005efd53868a96a1fcc24898ac7d6e3c
MD5 94bfbe9b937143ccd96e9fd9ce290748
BLAKE2b-256 0ad5424022d8bd9f19eb7cc61580da942dd8a98e0d47d50ab2de7bf627858580

See more details on using hashes here.

File details

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

File metadata

  • Download URL: praisonai_sandbox-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 74.2 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f0d0fefaccb78f1a02476d2da5a10a6d08adf715faa382d647715aa918ad5f6b
MD5 2fd2076513ca414114526265e94de088
BLAKE2b-256 fa019c8b65d619d0446f82c9b95fc4508b9f9f0f18d44236503cfddc5d5b7584

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

This release

0.1.0 This release

2 files

0.0.13

2 files

0.0.12

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