Repolode
rivet-dev

rivet-dev/agentos

WebAssembly와 V8를 기반으로 AI 에이전트에 파일, 프로세스, 셸, 네트워킹을 갖춘 격리된 Linux 유사 샌드박스를 제공하는 라이브러리이자 호스팅 서비스입니다.

스타
4,856
포크
275
열린 이슈
134
마지막 커밋
그저께

어떤 프로젝트인가요?

agentOS는 각 에이전트에 POSIX 스타일 파일, 프로세스, 셸, 네트워킹을 갖춘 작은 운영체제를 제공하는 AI 에이전트용 샌드박스입니다. 기존 Node.js 백엔드 안에서 실행되는 npm 패키지 @rivet-dev/agentos-core로 배포하거나, Rivet Cloud 또는 자체 호스팅 인프라에서 HTTP API로 이용할 수 있습니다.

게스트 코드는 JavaScript와 TypeScript의 경우 V8 isolate에서 실행되고, 셸, coreutils, Python은 WebAssembly로 실행됩니다. Rust 사이드카 프로세스가 커널을 관리하므로 신뢰할 수 없는 코드가 애플리케이션 프로세스에 들어오지 않습니다. 호스트 접근은 기본적으로 차단되며 마운트, 호스트 함수, 네트워크 권한을 통해 허용할 수 있습니다. 메모리 기반 또는 SQLite 기반 루트 파일시스템과 S3 마운트도 지원합니다.

README에 따르면 샌드박스 기준 환경과 비교한 벤치마크에서 콜드 스타트는 p50 기준 약 4.8ms, 셸 작업의 메모리 사용량은 약 22MB이며, 중첩 가상화나 에이전트별 microVM은 필요하지 않습니다.

핵심 기능

  • 01npm에서 설치해 Node.js 백엔드 프로세스 안에서 실행합니다.
  • 02JavaScript와 TypeScript는 V8 isolate에서, 셸과 Python은 WebAssembly로 실행합니다.
  • 03메모리, SQLite, S3, 호스트 디렉터리 마운트를 지원하는 가상 파일시스템을 제공합니다.
  • 04기본적으로 네트워크 접근을 차단하고, 호스트와 포트별 허용 규칙을 설정할 수 있습니다.
  • 05지속형 터미널, 백그라운드 프로세스, 예약된 cron 명령, 만료되는 미리보기 URL을 제공합니다.
  • 06브라우저 클라이언트에서 사용할 수 있도록 범위가 제한된 JWT를 지원하는 호스팅 HTTP API를 제공합니다.

활용 사례

  • LLM 에이전트가 생성한 코드나 셸 명령을 서버와 격리해 실행하기.
  • 에이전트마다 VM을 만들지 않고 작업용 파일시스템과 패키지 설치 환경 제공하기.
  • 원시 API 키를 노출하지 않고 에이전트가 애플리케이션 함수를 호출하게 하기.
  • 에이전트가 시작한 개발 서버를 임시 공개 미리보기 URL로 제공하기.

빠른 시작

  1. 1

    npm에서 라이브러리를 설치합니다

    npm install @rivet-dev/agentos-core
  2. 2

    백엔드에서 VM을 만들고 그 안에서 명령어, 파일, JavaScript 또는 Python을 실행합니다

사용 전 알아둘 점

  • 호스팅 옵션을 사용하려면 Rivet 계정과 RIVET_TOKEN이 필요하며, 셀프 호스팅에는 추가 설정이 필요합니다.
  • 게스트 코드는 WebAssembly 및 V8 isolate로 실행되므로 완전한 Linux 커널이나 마이크로 VM이 아닙니다.

포함된 컬렉션

토픽

자주 묻는 질문

agentos은(는) 무엇인가요?
WebAssembly와 V8를 기반으로 AI 에이전트에 파일, 프로세스, 셸, 네트워킹을 갖춘 격리된 Linux 유사 샌드박스를 제공하는 라이브러리이자 호스팅 서비스입니다. agentOS는 각 에이전트에 POSIX 스타일 파일, 프로세스, 셸, 네트워킹을 갖춘 작은 운영체제를 제공하는 AI 에이전트용 샌드박스입니다. 기존 Node.js 백엔드 안에서 실행되는 npm 패키지 @rivet-dev/agentos-core로 배포하거나, Rivet Cloud 또는 자체 호스팅 인프라에서 HTTP API로 이용할 수 있습니다.
agentos은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agentos은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agentos은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agentos의 마지막 커밋은 2026년 11월 5일입니다.
agentos은(는) 어디에 사용할 수 있나요?
LLM 에이전트가 생성한 코드나 셸 명령을 서버와 격리해 실행하기. 에이전트마다 VM을 만들지 않고 작업용 파일시스템과 패키지 설치 환경 제공하기. 원시 API 키를 노출하지 않고 에이전트가 애플리케이션 함수를 호출하게 하기. 에이전트가 시작한 개발 서버를 임시 공개 미리보기 URL로 제공하기.
agentos는 어떻게 설치하나요?
npm에서 라이브러리를 설치합니다: npm install @rivet-dev/agentos-core 백엔드에서 VM을 만들고 그 안에서 명령어, 파일, JavaScript 또는 Python을 실행합니다
agentos은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/rivet-dev/agentos

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트