rivet-dev/agentos

这是什么？

核心功能

• 01通过 npm 安装，可在 Node.js 后端进程内直接运行。
• 02JavaScript 和 TypeScript 在 V8 isolate 中执行，Shell 和 Python 以 WebAssembly 运行。
• 03虚拟文件系统支持内存、SQLite、S3 和宿主目录挂载。
• 04网络访问默认拒绝，可按主机和端口单独放行。
• 05支持交互式终端、后台进程、定时命令和可过期的预览 URL。
• 06托管模式提供 HTTP API，可为浏览器签发限定范围的 JWT。

适用场景

• 隔离运行 LLM 智能体生成的代码或 Shell 命令，避免影响服务器。
• 为智能体提供可读写的文件系统和包安装能力，无需为每个智能体单独起虚拟机。
• 让智能体调用应用中的函数，同时不暴露原始 API 密钥。
• 通过临时公开的预览 URL 访问智能体启动的开发服务器。

快速上手

1. 1

   从 npm 安装该库

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

   在后端创建虚拟机，并在其中运行命令、文件、JavaScript 或 Python

使用前须知

• !托管方案需要 Rivet 账户和 RIVET_TOKEN，自托管需要额外配置。
• !客户代码以 WebAssembly 和 V8 隔离环境运行，并非完整的 Linux 内核或微虚拟机。

收录于专题

标签

常见问题

agentos 是什么？

基于 WebAssembly 与 V8 的轻量沙箱，为 AI 智能体提供带文件、进程、Shell 和网络的类 Linux 环境。 agentOS 是一个面向 AI 智能体的沙箱，为每个智能体提供一个小型操作系统，包含 POSIX 风格的文件系统、进程、Shell 和网络。它以 npm 包 @rivet-dev/agentos-core 的形式发布，可直接运行在现有的 Node.js 后端进程中；也可以通过 Rivet Cloud 或自托管的 HTTP API 使用。

agentos 可以免费使用吗？用的什么许可证？

agentos 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

agentos 还在维护吗？

活跃维护中。agentos 最近一次提交是在 2026年11月5日。

agentos 适合用来做什么？

隔离运行 LLM 智能体生成的代码或 Shell 命令，避免影响服务器。 为智能体提供可读写的文件系统和包安装能力，无需为每个智能体单独起虚拟机。 让智能体调用应用中的函数，同时不暴露原始 API 密钥。 通过临时公开的预览 URL 访问智能体启动的开发服务器。

agentos 怎么安装和运行？

从 npm 安装该库: npm install @rivet-dev/agentos-core 在后端创建虚拟机，并在其中运行命令、文件、JavaScript 或 Python

在哪里获取 agentos？

源代码和安装说明在 GitHub 上：https://github.com/rivet-dev/agentos