AI 에이전트를 위한 비신뢰 코드를 작업별 CPU·메모리·시간 제한이 적용된 격리형 WebAssembly 샌드박스에서 실행하는 런타임입니다.
vndee/llm-sandbox
Docker, Kubernetes, Podman 및 로컬 Linux·Windows 백엔드에서 하나의 API로 LLM 생성 코드를 격리된 샌드박스에서 실행하는 Python 라이브러리입니다.
- 스타
- 1,144
- 포크
- 107
- 열린 이슈
- 25
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
LLM Sandbox는 언어 모델이 생성한 코드를 격리된 환경에서 실행할 수 있도록 공통 Python API를 제공합니다. 개발자는 Docker, Kubernetes, Podman, Bubblewrap, NsJail 또는 실험 단계의 Windows 어댑터 같은 백엔드를 선택하고 리소스 및 네트워크 제어를 설정한 뒤, 어떤 백엔드를 사용하든 동일한 run, install, 파일 복사 메서드를 호출하면 됩니다.
이 라이브러리는 Python, JavaScript, Java, C++, Go, R을 지원하며 실행 전에 선언된 라이브러리를 설치할 수 있습니다. 아티팩트 세션은 생성된 플롯을 저장하고, 대화형 세션에서는 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
PyPI에서 패키지를 설치합니다
pip install llm-sandbox - 2
가장 일반적인 백엔드용 Docker extra를 설치합니다
pip install 'llm-sandbox[docker]' - 3
SandboxSession을 사용해 README의 기본 Python 예제를 실행합니다
사용 전 알아둘 점
- 로컬 Linux 백엔드는 호스트 커널을 공유하므로 VM과 같은 격리 경계가 아닙니다.
- Windows 어댑터는 실험 단계이며, 지원하는 언어와 API 기능이 제한적입니다.
- Docker, Kubernetes, Podman과 같은 컨테이너 백엔드에는 실행 중인 컨테이너 런타임이 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- llm-sandbox은(는) 무엇인가요?
- Docker, Kubernetes, Podman 및 로컬 Linux·Windows 백엔드에서 하나의 API로 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]' SandboxSession을 사용해 README의 기본 Python 예제를 실행합니다
- llm-sandbox은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/vndee/llm-sandbox
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LLM이 생성한 Python 코드를 리소스 제한, 타임아웃, 안전 검사를 적용해 격리된 Docker 컨테이너에서 실행하는 Python 라이브러리이자 REST API입니다.
각 워크로드를 하드웨어 격리 MicroVM에서 실행하고 E2B SDK 호환성과 60ms 미만의 시작 시간을 제공하는 오픈소스 AI 에이전트 샌드박스 서비스입니다.
HTTP API로 제어하는 Firecracker microVM 격리 환경에서 에이전트와 사용자 코드를 실행하는 샌드박스 플랫폼입니다.
CLI, HTTP API, Python SDK로 제어하며 신뢰할 수 없는 코드를 경량 VM 샌드박스에서 실행하는 자체 호스팅 Kubernetes 인프라입니다.
AI 에이전트가 자체 인프라에서 코드, 명령, 파일, 브라우저를 실행할 수 있도록 격리된 환경을 제공하는 오픈소스 샌드박스 런타임입니다.