Repositories
仓库
Agent Sandbox 拆成下面几块，各自独立发布。CLI 和 Python SDK 默认只带提供方 alicloud-express。
abx 命令行
@agent-sandbox/cli在终端里创建沙箱、执行命令、上传下载文件、构建和部署模板。它也提供 MCP 服务，让 IDE 里的编码 Agent 直接调用沙箱。
- 创建、列出、查看、销毁、执行、连接、上传、下载
- abx template：搜索、安装、构建、发布模板
- abx mcp：写入 Cursor、Claude、VS Code 的配置，或启动 STDIO 服务
- Node.js 20+，也有 macOS、Linux、Windows 单文件二进制
@agent-sandbox/cli
npm install -g @agent-sandbox/cli
abx create --template basePython SDK
agent-sandbox · agent-sandbox-server跑在你机器上的异步客户端：Sandbox.create、commands.run、run_code、文件、端口、会话持久化和 @sandbox 声明式装饰器。agent-sandbox-server 是沙箱镜像里的 HTTP 服务。
- 三种执行方式：shell、代码解释器、模板里注册的命名命令
- 提供方插件：通过 providers 命令从 Registry 安装
- 同版本发布两个包，Python 3.10+
- 方法名接近 E2B，便于迁移，但不是协议级替换
agent-sandbox
pip install agent-sandbox
# 沙箱镜像里再装 agent-sandbox-serverNode.js SDK
@agent-sandbox/sdkNode.js 20+ 的 ESM 客户端，目前是第一片实现：配置名与环境变量的对照，以及访问沙箱内 agent-sandbox-server 的 ServerClient。
- 还不包含 Sandbox.create 和云提供方
- 创建云沙箱请继续用 Python SDK 或 abx
@agent-sandbox/sdk
npm install @agent-sandbox/sdk模板
awesome-templates模板描述沙箱里有什么：template.yaml、Dockerfile，以及在镜像里注册命名命令的 commands.py。公开目录里有 Python、浏览器自动化和多个编码 Agent 的运行环境。
- abx template install 构建并注册到极速版
- 每个模板都带 README 和端到端测试
- 在 Registry 上按名称、标签、能力筛选
awesome-templates
abx template install alibaba-agent-sandbox/awesome-templates//python-hello提供方
awesome-providers提供方决定沙箱跑在哪套后端上。目前目录里有 OpenSandbox、E2B、CubeSandbox 和阿里云容器版，每个都声明了自己支持的能力。
- 清单 abx-provider.toml 加一个小程序，三种运行时：rest、exec、python
- 安装包带 sha256，安装只复制文件
- 没声明的能力在请求发出前就报错
awesome-providers
python -m agent_sandbox.providers install registry:opensandbox --yesRegistry
registry.agent-sandbox.cn把模板、提供方和各仓库的文档做成可阅读、可搜索的目录，并提供 SDK 读取的机器可读索引。它不保存云账号密钥，也不会替访问者创建沙箱。
- 中英文页面和全站搜索
- providers/index.json 与可复现的 tar.gz 安装包
- 发布指南：提交 Pull Request 即可收录
registry.agent-sandbox.cn
curl -s https://registry.agent-sandbox.cn/providers/index.json