面向 AI Agent 的安全运行时,在隔离的 WebAssembly 沙箱中执行不可信代码,并可按任务限制 CPU、内存和超时。
vndee/llm-sandbox
一个 Python 库,通过统一 API 在 Docker、Kubernetes、Podman 及本地 Linux、Windows 沙箱中安全运行 LLM 生成的代码。
- Star
- 1,144
- Fork
- 106
- 未关闭 Issue
- 25
- 最近提交
- 昨天
这是什么?
LLM Sandbox 提供统一的 Python API,用于在隔离环境中执行语言模型生成的代码。开发者可以选择 Docker、Kubernetes、Podman、Bubblewrap、NsJail 或实验性的 Windows 适配器作为后端,配置资源和网络限制,之后无论使用哪种后端都调用相同的运行、安装和文件复制方法。
库支持 Python、JavaScript、Java、C++、Go 和 R,可在执行前安装指定依赖。Artifact 会话可以捕获生成的图表,交互式会话则在多次调用之间保持 IPython 内核状态,适合类 notebook 的工作方式。容器池选项可以预热并复用容器,减少重复执行的开销;MCP 服务器则让 Claude Desktop 等客户端直接调用沙箱。
项目提供了 LangChain、LlamaIndex、CrewAI 等十一个智能体框架的示例。其中的安全策略检查只是提供判断结果,不会阻止执行,调用方需要在运行前自行检查代码。
核心功能
- 01在 Docker、Kubernetes、Podman、Bubblewrap、NsJail 及 Windows 适配器之间使用统一 API
- 02可配置 CPU、内存、网络和执行时间限制
- 03支持 Python、JavaScript、Java、C++、Go 和 R
- 04执行前安装指定的依赖库
- 05捕获 Python 和 R 代码生成的图表
- 06容器池可复用预热好的容器
- 07提供 MCP 服务器,供 Claude Desktop 等客户端调用
适用场景
- 在把结果返回给用户之前,运行 LLM 智能体编写的代码
- 为 LangChain、CrewAI 等智能体框架添加代码解释器工具
- 在不使用 Docker 的本地 Linux 主机上执行不可信脚本
- 让对话助手安全地生成并展示图表
快速上手
- 1
从 PyPI 安装该包
pip install llm-sandbox - 2
安装 Docker 支持组件(最常用的后端)
pip install 'llm-sandbox[docker]' - 3
运行 README 中的基础 Python 示例(使用 SandboxSession)
使用前须知
- 本地 Linux 后端与宿主机共享内核,并非虚拟机级别的隔离边界。
- Windows 适配器为实验性功能,语言支持和 API 功能有限。
- Docker、Kubernetes、Podman 等容器后端需要正在运行的容器运行时。
收录于专题
标签
常见问题
- llm-sandbox 是什么?
- 一个 Python 库,通过统一 API 在 Docker、Kubernetes、Podman 及本地 Linux、Windows 沙箱中安全运行 LLM 生成的代码。 LLM Sandbox 提供统一的 Python API,用于在隔离环境中执行语言模型生成的代码。开发者可以选择 Docker、Kubernetes、Podman、Bubblewrap、NsJail 或实验性的 Windows 适配器作为后端,配置资源和网络限制,之后无论使用哪种后端都调用相同的运行、安装和文件复制方法。
- llm-sandbox 可以免费使用吗?用的什么许可证?
- llm-sandbox 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- llm-sandbox 还在维护吗?
- 活跃维护中。llm-sandbox 最近一次提交是在 2026年11月6日。
- llm-sandbox 适合用来做什么?
- 在把结果返回给用户之前,运行 LLM 智能体编写的代码 为 LangChain、CrewAI 等智能体框架添加代码解释器工具 在不使用 Docker 的本地 Linux 主机上执行不可信脚本 让对话助手安全地生成并展示图表
- llm-sandbox 怎么安装和运行?
- 从 PyPI 安装该包: pip install llm-sandbox 安装 Docker 支持组件(最常用的后端): pip install 'llm-sandbox[docker]' 运行 README 中的基础 Python 示例(使用 SandboxSession)
- 在哪里获取 llm-sandbox?
- 源代码和安装说明在 GitHub 上:https://github.com/vndee/llm-sandbox
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一个 Python 库和 REST API,在隔离的 Docker 容器中安全执行 LLM 生成的 Python 代码,并支持资源限制与超时控制。
面向 AI Agent 的开源沙箱服务,每个任务运行在硬件隔离的 MicroVM 中,兼容 E2B SDK。
基于 Firecracker 微虚拟机的沙箱平台,通过 HTTP API 隔离运行智能体与用户代码。
自托管的基于 Kubernetes 的平台,用轻量虚拟机沙箱安全执行不可信代码,提供 CLI、API 与 Python SDK。
开源沙箱运行时,为 AI 智能体提供隔离环境,用于执行代码、命令、文件及浏览器操作。