UCloud Sandbox Python SDK

UCloud Sandbox Python SDK 提供云端沙箱环境，用于安全运行 AI 生成的代码。

安装

pip install ucloud_sandbox

快速开始

1. 获取 API Key

访问星图平台注册账号
在密钥管理获取 API Key
设置环境变量：

export UCLOUD_SANDBOX_API_KEY=your_api_key

2. 基础沙箱

from ucloud_sandbox import Sandbox

with Sandbox.create() as sandbox:
    result = sandbox.commands.run("echo 'Hello, World!'")
    print(result.stdout)

3. Code Interpreter（代码解释器）

支持有状态的代码执行，变量在多次调用之间保持：

from ucloud_sandbox.code_interpreter import Sandbox

with Sandbox.create() as sandbox:
    sandbox.run_code("x = 1")
    execution = sandbox.run_code("x += 1; print(x)")
    print(execution.logs.stdout)  # ['2']

4. Desktop（桌面环境）

支持鼠标键盘控制、截图、VNC 流媒体：

from ucloud_sandbox.desktop import Sandbox

desktop = Sandbox.create()

# 截图
screenshot = desktop.screenshot()

# 鼠标操作
desktop.left_click(100, 200)
desktop.write("Hello, World!")

# VNC 流
desktop.stream.start()
print(desktop.stream.get_url())

desktop.kill()

私有化 HTTP 部署

私有化服务未配置 TLS 时，设置 sandbox 域名并启用非安全 HTTP：

export UCLOUD_SANDBOX_DOMAIN=sandbox.example.com
export UCLOUD_SANDBOX_INSECURE_HTTP=true

默认管理 API 地址为 http://api.<domain>；如果实际地址不符合这个规则，再通过 UCLOUD_SANDBOX_API_URL 指定完整 URL。

也可以在调用时传入参数：

from ucloud_sandbox import Sandbox

sandbox = Sandbox.create(
    api_url="http://api.sandbox.example.com",
    domain="sandbox.example.com",
    insecure_http=True,
)

UCLOUD_SANDBOX_INSECURE_HTTP 默认为 false；仅应在可信私有网络中启用。

文档

访问 UCloud Agent Sandbox 文档获取更多信息。

致谢

本项目基于 E2B 开源项目开发，感谢 E2B 团队的贡献。

许可证

MIT License - 详见 LICENSE 文件

Metadata

Release files for ucloud-sandbox 1.4.4

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

Source distribution (sdist)

Source distribution for ucloud-sandbox 1.4.4
File	Size	Uploaded
ucloud_sandbox-1.4.4.tar.gz	186.5 kB	Sep 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ucloud-sandbox 1.4.4
File	Interpreter	ABI	Platform	Reset
ucloud_sandbox-1.4.4-py3-none-any.whl 346.4 kB Sep 7, 2026	Python 3	none	any	Details

Total release size: 532.8 kB

Release files / ucloud_sandbox-1.4.4.tar.gz

Download URL	ucloud_sandbox-1.4.4.tar.gz
Size	186.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`1b3f176bb3435497fe5a051bcf2071170b1a5dc7df65e0700ed14dfa1307c0c8`
BLAKE2b-256 checksum How to use checksums	`8881a9e91936ac52f0169cb16dd2bf36488906485e80c07982d6179c15cdcc7b`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / ucloud_sandbox-1.4.4-py3-none-any.whl

Download URL	ucloud_sandbox-1.4.4-py3-none-any.whl
Size	346.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4ff3ca781c63fa8ed754c53145a43e6afe1b9c508aa54e11505d31a1005de0aa`
BLAKE2b-256 checksum How to use checksums	`7d8075f157dc1352792685be6ffd51eb9d12bd2242a624556eeaca6a1f80bfbf`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`