agent-infra/sandbox

어떤 프로젝트인가요?

핵심 기능

• 01VNC, Chrome DevTools Protocol, MCP 도구를 통한 브라우저 제어
• 02하나의 파일 시스템을 공유하는 셸 터미널 및 파일 읽기/쓰기 작업
• 03브라우저에서 코드를 작성할 수 있도록 내장된 VSCode Server와 JupyterLab
• 04브라우저·파일·셸·문서 변환용으로 미리 구성된 MCP 서버
• 05샌드박스 내부에서 Python 및 Node.js 코드 실행
• 06API 및 서비스 엔드포인트에 선택적으로 적용할 수 있는 API 키 인증

활용 사례

• AI 에이전트가 셸 명령과 코드를 안전하게 실행할 수 있는 환경 제공
• 작업 후 다운로드한 파일을 처리해야 하는 브라우저 작업 자동화
• 개발자를 위한 일회용 클라우드 IDE를 컨테이너에서 호스팅
• browser-use나 LangChain 같은 에이전트 프레임워크를 즉시 사용할 수 있는 도구 환경에 연결

빠른 시작

1. 1

   API 키를 사용해 샌드박스 컨테이너를 실행합니다(권장).

   docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest
2. 2

   localhost:8080에서 문서를 엽니다.

3. 3

   Python SDK를 설치합니다(선택 사항).

   pip install agent-sandbox

사용 전 알아둘 점

• !Docker가 필요하며, 컨테이너는 seccomp unconfined로 실행됩니다.
• !설정하려면 용량이 큰 올인원 컨테이너 이미지를 pull해야 합니다.

토픽

자주 묻는 질문

sandbox은(는) 무엇인가요?

AI 에이전트가 브라우저, 셸, 파일 시스템, VSCode Server, Jupyter, MCP 서비스를 함께 쓰는 올인원 Docker 샌드박스 AIO Sandbox는 브라우저, 터미널, 파일 시스템, VSCode Server, Jupyter, MCP 서비스를 하나의 Docker 컨테이너에 담습니다. 에이전트와 개발자는 같은 환경에서 셸 명령을 실행하고, 파일을 읽고 쓸 수 있으며, 브라우저를 제어하고 Python 또는 Node.js 코드를 실행할 수 있습니다. 따라서 브라우저에서 다운로드한 파일을 셸과 파일 작업에서 바로 사용할 수 있습니다.

sandbox은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

sandbox은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

sandbox은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. sandbox의 마지막 커밋은 2026년 9월 14일입니다.

sandbox은(는) 어디에 사용할 수 있나요?

AI 에이전트가 셸 명령과 코드를 안전하게 실행할 수 있는 환경 제공 작업 후 다운로드한 파일을 처리해야 하는 브라우저 작업 자동화 개발자를 위한 일회용 클라우드 IDE를 컨테이너에서 호스팅 browser-use나 LangChain 같은 에이전트 프레임워크를 즉시 사용할 수 있는 도구 환경에 연결

sandbox는 어떻게 설치하나요?

API 키를 사용해 샌드박스 컨테이너를 실행합니다(권장).: docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest localhost:8080에서 문서를 엽니다. Python SDK를 설치합니다(선택 사항).: pip install agent-sandbox

sandbox은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/agent-infra/sandbox