Repolode
vndee

vndee/llm-sandbox

Docker、Kubernetes、Podman、ローカルのLinuxやWindowsなど、複数のバックエンドでLLM生成コードを隔離環境内で実行するPythonライブラリ。

スター
1,144
フォーク
106
未解決の Issue
25
最終コミット
昨日

これは何?

LLM Sandboxは、言語モデルが生成したコードを隔離環境内で実行するための共通Python APIを提供します。開発者はDocker、Kubernetes、Podman、Bubblewrap、NsJail、実験的なWindowsアダプターなどのバックエンドを選び、リソースやネットワークの制御を設定したうえで、使用するバックエンドにかかわらず同じrun、install、ファイルコピー用のメソッドを呼び出せます。

Python、JavaScript、Java、C++、Go、Rに対応し、実行前に宣言されたライブラリをインストールできます。Artifact sessionでは生成されたプロットを取得でき、インタラクティブセッションではPython IPythonカーネルを呼び出し間で起動したままにして、ノートブックのように作業できます。コンテナプール機能では、繰り返し実行に備えてコンテナを事前に起動して再利用できます。また、MCPサーバーを使うと、Claude Desktopなどのクライアントからサンドボックスを直接呼び出せます。

LangChain、LlamaIndex、CrewAIを含む11種類のエージェントフレームワーク向けのサンプルが用意されています。セキュリティポリシーのチェックはあくまで参考情報を返すだけで、実行をブロックしません。そのため、コードを実行する前に呼び出し側で確認する必要があります。

主な機能

  • 01Docker、Kubernetes、Podman、Bubblewrap、NsJail、Windowsアダプターで共通のAPIを提供
  • 02CPU、メモリ、ネットワーク、実行時間の上限を設定可能
  • 03Python、JavaScript、Java、C++、Go、Rに対応
  • 04コードの実行前に宣言されたライブラリをインストール
  • 05PythonやRのコードが生成したプロットを取得
  • 06事前起動したコンテナを再利用するコンテナプール
  • 07Claude Desktopなどのクライアント向けMCPサーバー

ユースケース

  • LLMエージェントが作成したコードを実行し、結果をユーザーに返す
  • LangChain、CrewAIなどのエージェントフレームワークにコードインタープリター機能を追加する
  • Dockerを使わず、ローカルのLinuxホストで信頼できないスクリプトを実行する
  • チャットアシスタントが安全にプロットを生成して表示できるようにする

クイックスタート

  1. 1

    PyPI からパッケージをインストールする

    pip install llm-sandbox
  2. 2

    最も一般的なバックエンド用の Docker extra をインストールする

    pip install 'llm-sandbox[docker]'
  3. 3

    README の基本的な Python サンプルを SandboxSession で実行する

使う前に知っておきたいこと

  • ローカルの Linux バックエンドはホストカーネルを共有しており、VM の隔離境界にはなりません。
  • Windows アダプターは実験的なもので、対応言語と API 機能が限られています。
  • Docker、Kubernetes、Podman などのコンテナバックエンドには、稼働中のコンテナランタイムが必要です。

収録されている特集

トピック

よくある質問

llm-sandbox とは?
Docker、Kubernetes、Podman、ローカルのLinuxやWindowsなど、複数のバックエンドでLLM生成コードを隔離環境内で実行するPythonライブラリ。 LLM Sandboxは、言語モデルが生成したコードを隔離環境内で実行するための共通Python APIを提供します。開発者はDocker、Kubernetes、Podman、Bubblewrap、NsJail、実験的なWindowsアダプターなどのバックエンドを選び、リソースやネットワークの制御を設定したうえで、使用するバックエンドにかかわらず同じrun、install、ファイルコピー用のメソッドを呼び出せます。
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 extra をインストールする: pip install 'llm-sandbox[docker]' README の基本的な Python サンプルを SandboxSession で実行する
llm-sandbox はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/vndee/llm-sandbox

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト