# 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](https://ppio.com/docs/sandbox/overview) for more information.
## Installation
```bash
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](https://ppio.com/docs/sandbox/get-start).
### Core
The basic package provides a way to interact with the sandbox environment.
```python
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.
```python
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.
```python
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()
```
Raw data
{
"_id": null,
"home_page": "https://ppio.com/",
"name": "ppio-sandbox",
"maintainer": "PPIO",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "viktor@pplabs.org",
"keywords": "ppio, sandbox, ai, agent, sdk, code-interpreter, desktop-automation",
"author": "PPIO",
"author_email": "viktor@pplabs.org",
"download_url": "https://files.pythonhosted.org/packages/d2/bc/e66ddc3401cc129957ed12a8f58176dae0259ff1c81a642dac7fbb8df6ed/ppio_sandbox-1.0.0.tar.gz",
"platform": null,
"description": "# PPIO Sandbox SDK for Python\n\nPython SDK for PPIO Sandbox environments, providing code execution, desktop automation, and cloud computing capabilities, which is compatible with e2b.\n\nPlease read the [documentation](https://ppio.com/docs/sandbox/overview) for more information.\n\n## Installation\n\n```bash\npip install ppio-sandbox\n```\n\n## Features\n\n- \ud83d\ude80 **Code Interpreter**: Execute Python, JavaScript, and other languages in isolated environments\n- \ud83d\udda5\ufe0f **Desktop Automation**: Control desktop applications and GUI interactions\n- \u2601\ufe0f **Cloud Computing**: Scalable sandbox environments for various computing tasks\n- \ud83d\udcca **Data Visualization**: Built-in charting and visualization capabilities\n- \ud83d\udd27 **File System Operations**: Complete file system management and monitoring\n\n## Quick Start\n\n### Authentication\n\nYou can get the PPIO API key by refer to this [documentation](https://ppio.com/docs/sandbox/get-start).\n\n### Core\n\nThe basic package provides a way to interact with the sandbox environment.\n\n```python\nfrom ppio_sandbox.core import Sandbox\nimport os\n\n# Using the official template `base` by default\nsandbox = Sandbox.create(\n template=\"base\",\n api_key=os.getenv(\"PPIO_API_KEY\", \"\")\n)\n\n# File operations\nsandbox.files.write('/tmp/test.txt', 'Hello, World!')\ncontent = sandbox.files.read('/tmp/test.txt')\n\n# Command execution\nresult = sandbox.commands.run('ls -la /tmp')\nprint(result.stdout)\n\nsandbox.kill()\n```\n\n### Code Interpreter\n\nThe Code Interpreter sandbox provides a Jupyter-like environment for executing code using the official `code-interpreter-v1` template.\n\n```python\nfrom ppio_sandbox.code_interpreter import Sandbox\nimport os\n\nsandbox = Sandbox.create(\n api_key=os.getenv(\"PPIO_API_KEY\", \"\")\n)\n\n# Execute Python code\nresult = sandbox.run_code('print(\"Hello, World!\")')\nprint(result.logs)\n\nsandbox.kill()\n```\n\n### Desktop\n\nThe Desktop sandbox allows you to control desktop environments programmatically using the official `desktop` template.\n\n```python\nfrom ppio_sandbox.desktop import Sandbox\nimport os\n\ndesktop = Sandbox.create(\n api_key=os.getenv(\"PPIO_API_KEY\", \"\")\n)\n\n# Take a screenshot\nscreenshot = desktop.screenshot()\n\n# Automate mouse and keyboard\ndesktop.left_click(100, 200)\ndesktop.press('Return')\ndesktop.write('Hello, World!')\n\ndesktop.kill()\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "PPIO Sandbox SDK - Python library for PPIO Agent Sandbox",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/ppio/ppio-sandbox-sdk-python/issues",
"Changelog": "https://github.com/ppio/ppio-sandbox-sdk-python/blob/main/CHANGELOG.md",
"Documentation": "https://ppio-sandbox-sdk-python.readthedocs.io/",
"Homepage": "https://ppio.com/",
"Repository": "https://github.com/ppio/ppio-sandbox-sdk-python"
},
"split_keywords": [
"ppio",
" sandbox",
" ai",
" agent",
" sdk",
" code-interpreter",
" desktop-automation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b19e71dcb29a8f058d16d9d41d4c423edddec9edac6bcb618f21736dc8bab742",
"md5": "9225c78c7615fea5533dd208bd59ebbf",
"sha256": "f1c0c582bf20d5e4fdc23c538c63f73017178a1cbc79ecebaa9860e6b08d4a77"
},
"downloads": -1,
"filename": "ppio_sandbox-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9225c78c7615fea5533dd208bd59ebbf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 215294,
"upload_time": "2025-08-30T07:41:48",
"upload_time_iso_8601": "2025-08-30T07:41:48.975135Z",
"url": "https://files.pythonhosted.org/packages/b1/9e/71dcb29a8f058d16d9d41d4c423edddec9edac6bcb618f21736dc8bab742/ppio_sandbox-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d2bce66ddc3401cc129957ed12a8f58176dae0259ff1c81a642dac7fbb8df6ed",
"md5": "610751a4bd4882edb80569141ded9e25",
"sha256": "6dd0e4de9c4398313e37ffd394a3acff5be2ae74c115ec850096d1875d72b60e"
},
"downloads": -1,
"filename": "ppio_sandbox-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "610751a4bd4882edb80569141ded9e25",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9603658,
"upload_time": "2025-08-30T07:41:55",
"upload_time_iso_8601": "2025-08-30T07:41:55.042837Z",
"url": "https://files.pythonhosted.org/packages/d2/bc/e66ddc3401cc129957ed12a8f58176dae0259ff1c81a642dac7fbb8df6ed/ppio_sandbox-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-30 07:41:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ppio",
"github_project": "ppio-sandbox-sdk-python",
"github_not_found": true,
"lcname": "ppio-sandbox"
}
JSON
