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.3.tar.gz (76.9 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.3-py3-none-any.whl (75.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: praisonai_sandbox-0.1.3.tar.gz
  • Upload date:
  • Size: 76.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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.3.tar.gz
Algorithm Hash digest
SHA256 61d9f6a9c2f9df7ce05d41a59717d92572f0a7330fa079147449d1d8c1ba718d
MD5 6b1fbe1d633b15b76ab4376937a448c7
BLAKE2b-256 1e6b6fb9f856de974b2a0320eb241b522b5c7fb4e654cb46ca77a9e76e805e5e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: praisonai_sandbox-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 75.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b776d6d4c270d988972fbfc6b462290034886a03ae0d558c01415621690a884e
MD5 067ea1a6331deee9c90e26cb4bd8d3f8
BLAKE2b-256 4f2976b2b8dc5bc5084c2060d6cedb40223b486080654b3129832fa34bedc115

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

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