desktop

环境要求

• E2B 账号与 API Key（需前往 e2b.dev 注册获取）
• Python 环境（使用 Python SDK 时）或 Node.js 环境（使用 JavaScript SDK 时）
• 可访问 E2B 云服务的网络连接

安装与启动步骤

1. 1注册并获取密钥

   前往 e2b.dev 注册账号，在控制台获取 E2B API Key，后续创建沙箱时需要用它做身份验证。

2. 2安装 Python SDK

   使用 pip 安装 e2b-desktop 包，即可在 Python 中调用桌面沙箱能力。

   pip install e2b-desktop

   复制

3. 3安装 JS SDK

   如果使用 JavaScript/Node.js，改用 npm 安装 @e2b/desktop；两种语言按需选一种即可。

   npm install @e2b/desktop

   复制

4. 4创建桌面沙箱

   Python 中导入 Sandbox 并调用 Sandbox.create() 启动一个隔离的虚拟桌面环境。

   from e2b_desktop import Sandbox
   
   desktop = Sandbox.create()

   复制

5. 5在沙箱执行命令

   通过 commands.run 在沙箱内运行任意 bash 命令，返回结果不会影响你的宿主机。

   out = desktop.commands.run("ls -la /home/user")
   print(out)

   复制

6. 6JavaScript 调用示例

   JavaScript 用法与 Python 一致，创建沙箱后同样用 commands.run 执行 bash 命令。

   import { Sandbox } from '@e2b/desktop'
   
   const desktop = await Sandbox.create()
   const out = await desktop.commands.run('ls -la /home/user')
   console.log(out)

   复制

关键配置

如何确认成功

运行示例代码后成功打印出 ls -la /home/user 的目录列表输出，即说明沙箱已创建且命令执行正常。

常见问题

注意事项

• 沙箱之间彼此隔离，AI 的操作不会影响宿主机环境。
• 本仓库当前只保留沙箱模板和示例，SDK 源码位于 E2B 主仓库。
• README 的入门章节内容被截断，更详细的配置与用法请以 E2B 官方文档为准。