PPIO Sandbox SDK for Python

Python SDK for PPIO Sandbox environments, providing code execution, desktop automation, and cloud computing capabilities, which is compatible with e2b.

Please read the documentation for more information.

Installation

pip install ppio-sandbox

Features

🚀 Code Interpreter: Execute Python, JavaScript, and other languages in isolated environments
🖥️ Desktop Automation: Control desktop applications and GUI interactions
☁️ Cloud Computing: Scalable sandbox environments for various computing tasks
📊 Data Visualization: Built-in charting and visualization capabilities
🔧 File System Operations: Complete file system management and monitoring

Quick Start

Authentication

You can get the PPIO API key by refer to this documentation.

Core

The basic package provides a way to interact with the sandbox environment.

from ppio_sandbox.core import Sandbox
import os

# Using the official template `base` by default
sandbox = Sandbox.create(
    template="base",
    api_key=os.getenv("PPIO_API_KEY", "")
)

# File operations
sandbox.files.write('/tmp/test.txt', 'Hello, World!')
content = sandbox.files.read('/tmp/test.txt')

# Command execution
result = sandbox.commands.run('ls -la /tmp')
print(result.stdout)

sandbox.kill()

Code Interpreter

The Code Interpreter sandbox provides a Jupyter-like environment for executing code using the official code-interpreter-v1 template.

from ppio_sandbox.code_interpreter import Sandbox
import os

sandbox = Sandbox.create(
    api_key=os.getenv("PPIO_API_KEY", "")
)

# Execute Python code
result = sandbox.run_code('print("Hello, World!")')
print(result.logs)

sandbox.kill()

Desktop

The Desktop sandbox allows you to control desktop environments programmatically using the official desktop template.

from ppio_sandbox.desktop import Sandbox
import os

desktop = Sandbox.create(
    api_key=os.getenv("PPIO_API_KEY", "")
)

# Take a screenshot
screenshot = desktop.screenshot()

# Automate mouse and keyboard
desktop.left_click(100, 200)
desktop.press('Return')
desktop.write('Hello, World!')

desktop.kill()

Development

Install

poetry install --with dev --extras "all"

Test

make test
make test-core
make test-code-interpreter
make test-desktop

Metadata

Release files for ppio-sandbox 2.1.0a6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ppio-sandbox 2.1.0a6
File	Size	Uploaded
ppio_sandbox-2.1.0a6.tar.gz	531.9 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ppio-sandbox 2.1.0a6
File	Interpreter	ABI	Platform	Reset
ppio_sandbox-2.1.0a6-py3-none-any.whl 645.9 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / ppio_sandbox-2.1.0a6.tar.gz

Download URL	ppio_sandbox-2.1.0a6.tar.gz
Size	531.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`0c840144e80e13efaa21113d7cbfe1a5286a3b846bc53710d19ebf3e1d4f872b`
BLAKE2b-256 checksum How to use checksums	`b6ee1fa94f73267c256a620828bdbdaebc1b1b65d5f47363fa0871123efb14d4`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.2 CPython/3.12.14 Linux/6.17.0-1022-azure`

Release files / ppio_sandbox-2.1.0a6-py3-none-any.whl

Download URL	ppio_sandbox-2.1.0a6-py3-none-any.whl
Size	645.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6d22a3ed2501608a58a8685fd0a95c9e1e0360eb2a49bb184ae43584b4313784`
BLAKE2b-256 checksum How to use checksums	`bf728aa7540dfddcb5e03a33a1d6ecd211d5c7792fd3a49a24a98d0e9c969b75`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.2 CPython/3.12.14 Linux/6.17.0-1022-azure`