vivek1504/agent-sandbox

Secure, Firecracker microVMs를 사용하여 AI 대리인을 위한 하드웨어 격리된 실행 sandbox

⭐ 이 프로젝트를 좋아한다면 GitHub에서 별!

개요 • 건축 • 기능 • 시작하기 • 통합 및 SDK • 보안 모델 • 성능 • 구성

---

개요

AI 에이전트는 실제 작업을 수행해야합니다 : 생성 및 실행 코드, 타사 의존성을 설치, 쿼리 원격 API, 실행 배경 프로세스 및 조작 파일. 호스트 기계의 에이전트 생성 된 코드를 실행하는 것은 위험합니다. 기존 컨테이너 샌드 박스링은 커널 악용, 더러운 sysctls 및 리소스 배출에 취약한 호스트 커널을 공유합니다.

Agent Sandbox는 전용 Firecracker microVM과 각 AI 에이전트 세션을 제공합니다. pre-baked snapshots에서 밀리 초에 세션 부팅, 자신의 리눅스 커널과 함께 완전한 하드웨어 고립에서 실행, 그리고 실행 완료 때 자동으로 찢어.

[!노트] **Sub-100ms 콜드 시작 **: Firecracker 스냅 샷 복원을 사전 감독 된 루트 파일 시스템, microVM 게스트 상태는 ** ~ 2에서 복원합니다.

---

Overview

AI agents need to perform real-world actions: generate and execute code, install third-party dependencies, query remote APIs, run background processes, and manipulate files. Running untrusted, agent-generated code on the host machine is dangerous, while conventional container sandboxing shares the host kernel—leaving systems vulnerable to kernel exploits, dirty sysctls, and resource exhaustion.

Agent Sandbox provides each AI agent session with a dedicated Firecracker microVM. Sessions boot in milliseconds from pre-baked snapshots, run in complete hardware isolation with their own Linux kernel, and are automatically torn down when execution completes.

[!NOTE] Sub-100ms Cold Starts: By combining Firecracker snapshot restoration with pre-provisioned root filesystems, microVM guest state restores in ~2.6ms (total end-to-end cold start is ~90ms including dedicated Linux network namespace, veth pair, TAP device, and NAT egress provisioning).

---

Architecture

Agent Sandbox separates untrusted guest execution from the host control plane through strict virtualization and network boundaries.

┌─────────────────────────────────────────────────────────────────────────┐
│                           Host (Linux + KVM)                            │
│                                                                         │