Repolode
vndee

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. 1

    从 PyPI 安装该包

    pip install llm-sandbox
  2. 2

    安装 Docker 支持组件(最常用的后端)

    pip install 'llm-sandbox[docker]'
  3. 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 数据每日更新。

相关项目