SuperAPI AI 工具集

zeroboot-vm-sandbox

智能体与模型

查看项目

更新于 10-16 07:27

技能介绍

Zeroboot 是面向 AI 智能体的代码执行沙箱服务,用真实 KVM 虚拟机(Firecracker + KVM)而非容器或进程隔离,适合安全运行 LLM 生成的不可信代码。

原理:模板 VM 启动一次并预载运行时,快照内存与 CPU 状态;每次执行通过 mmap(MAP_PRIVATE) 写时复制语义分叉新 VM,约 0.8ms 完成,各分叉具备独立内核、vCPU 与页表,内存隔离由硬件强制,CoW 使仅被写入的页占用额外内存。官方给出的性能参考:分叉延迟 p50 约 0.79ms、p99 约 1.74ms,每沙箱内存约 265KB,分叉加执行 Python 约 8ms,1000 并发分叉约 815ms。

安装:Python 用 pip install zeroboot;Node/TypeScript 用 npm install @zeroboot/sdk 或 pnpm add @zeroboot/sdk。认证通过环境变量设置 API 密钥:export ZEROBOOT_API_KEY="zb_live_your_key_here",不要硬编码密钥。

使用方式:REST API 为 POST https://api.zeroboot.dev/v1/exec,请求体 {"code": "..."},需 Authorization: Bearer 与 Content-Type: application/json,响应含 output 与 duration_ms;健康检查为 GET /v1/health。Python 中创建 Sandbox 后调用 sb.run(code);TypeScript 中 new Sandbox(apiKey) 后 await sb.run(code)。支持并发与封装为智能体工具。

自托管需 Linux 主机支持 KVM(/dev/kvm 可访问)、Firecracker 二进制与 Rust 2021 工具链,仓库含 docs/DEPLOYMENT.md。限制与注意:执行超时由服务端强制,应避免死循环或阻塞 I/O;密钥无效返回 401;自托管内存随沙箱写入增长,需按可用内存调整并发上限。收费、价格与平台等细节暂未提供。