agentos

把代理当进程跑,无需沙箱虚拟机,直接嵌入现有后端。

agentos 是一个用 Rust 编写的开源库,旨在为 AI 代理提供类似操作系统的底层支持。它解决了代理运行环境隔离与资源管理的问题,允许开发者将代理直接集成到现有后端服务中,无需依赖沙箱、虚拟机或外部 SaaS 服务。其核心能力基于 WebAssembly 和 V8 隔离技术,为每个代理提供独立、安全的执行环境,同时保持轻量和高性能。通过库的形式,开发者可以灵活控制代理的生命周期、内存与 CPU 资源,并实现细粒度的权限管理。它适合需要高安全性和低延迟的代理部署场景,如自动化工具、数据处理管道等。项目目前处于成长阶段,社区活跃度较高。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 4656
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队rivet-dev
所属国家
定价模式free
价格说明开源项目,基于 Apache-2.0 许可证,可自由使用和部署,无付费版本。
访问状态
是否开源是
开源协议Apache-2.0
主要语言Rust
技术栈/模型agent,ai,javascript,llm,sandbox,v8,wasm,webassembly
GitHub 星标★ 4656
30天Star增速
HF 下载量
上线时间2024-02-07 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 6 步

环境要求

  • Node.js 运行环境(需支持 npx)
  • 已安装 npm
  • 使用 Pi 等内置代理时需要 ANTHROPIC_API_KEY 等模型凭证
  • TypeScript 客户端脚本需可用的 tsx 运行器

安装与启动步骤

  1. 1安装依赖包

    在项目目录下安装 agentOS 库和 Pi 代理软件包。常用 POSIX 工具已在 VM 内开箱即用,无需额外安装。

    npm install @rivet-dev/agentos @agentos-software/pi
  2. 2编写服务端

    新建 server.ts,用 agentOS 声明软件并导出 registry,调用 registry.start() 启动。

  3. 3启动本地服务

    在第一个终端启动本地开发服务,客户端将通过 6420 端口连接该服务。

    npx rivetkit dev
  4. 4编写客户端

    新建 client.ts,用 createClient 连接端点,getOrCreate 获取 VM 句柄,connect() 订阅流式事件。

  5. 5打开会话并提问

    调用 openSession 指定代理与环境变量,再用 prompt 发送文本指令,例如让代理写文件。

  6. 6运行客户端

    在第二个终端执行客户端脚本,观察事件输出与代理生成的 /workspace/hello.js 内容。

    npx tsx client.ts

关键配置

配置项必填说明示例
endpoint是客户端连接服务端的地址http://localhost:6420
agent是openSession 时指定要使用的代理名称pi
env.ANTHROPIC_API_KEY是传给代理的模型凭证,仅代理侧可见sk-xxxxxxxx

如何确认成功

第二个终端输出代理会话事件,并打印出 /workspace/hello.js 的文件内容。

常见问题

Q:如何把 VM 嵌进已有 Node.js 应用?

A:改用 @rivet-dev/agentos-core,调用 AgentOs.create() 启动 VM 并直接拿到句柄,无需 Rivet Actor 运行时。

Q:支持哪些内置代理?

A:内置 ACP 代理包括 Pi、Claude Code、Codex 和 OpenCode,后三者的安装方式与 Pi 完全相同。

Q:可以部署到哪里?

A:它只是一个 npm 包,可部署到 Rivet Cloud 托管基础设施,也可自托管在自己的服务器上。

Q:VM 里能跑 Node 和 Shell 吗?

A:可以。用 handle.exec 执行 node 脚本或 bash 命令,并可通过 stdout 读取执行结果。

注意事项

  • agentOS 处于预览阶段,API 可能发生变化。
  • 权限默认严格控制,网络出口等对外能力默认拒绝。
  • 凭证保留在宿主机侧,代理只能看到输入与输出。
  • 项目采用 Apache 2.0 许可证。

核心亮点

  • 基于 WebAssembly 和 V8 隔离,提供真正的内存与 CPU 级安全隔离,远超普通线程。
  • 以库形式运行,无需额外基础设施,部署简单,与现有 Rust 后端无缝集成。
  • 资源控制精细,可限制每个代理的 CPU、内存,适合多租户场景。

不足之处

  • 文档/社区待观察
  • Rust 技术栈门槛较高,非 Rust 项目集成成本大。

适用场景

  • 在现有后端服务中安全运行不可信的 AI 代理代码。
  • 多租户 SaaS 中为每个用户隔离代理执行环境。
  • 边缘计算或资源受限环境下的轻量代理部署。

替代项目

wasmtime、Extism、suborbital

项目介绍

agentos 是基础设施领域的开源项目,由 rivet-dev 开发,2024 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(4,656)位列前 10%,在基础设施分类的 1,132 个项目里位列前 14%。

近 41 天,它的 GitHub 星标从 4,369 增加到 4,656,净增 287。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。基于 Apache-2.0 许可证,可自由使用和部署,无付费版本。

它主要面向的使用场景是:在现有后端服务中安全运行不可信的AI代理代码。同类可对比的替代方案包括 wasmtime、Extism、suborbital。

上一篇:axonhub

下一篇:optillm

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

Multi-account OpenAI-compatible gateway for coding models. Pooled keys, session life···

★ 213 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09