agentos

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署 开源模型 🍴 复刻 275 🐛 待处理 141 👀 关注 11
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 4866
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目，基于 Apache-2.0 许可证，可自由使用和部署，无付费版本。

项目预览

agentos 项目界面预览图
图片来源：项目官网

项目数据

分类开源模型
开发团队rivet-dev
官网地址https://rivet.dev/agentos
GitHubhttps://github.com/rivet-dev/agentos
定价模式🏷️完全免费
价格说明开源项目，基于 Apache-2.0 许可证，可自由使用和部署，无付费版本。
访问状态🔧 仅开源项目，无在线服务，需自行部署
是否开源是
开源协议Apache-2.0
主要语言Rust
技术栈/模型agent,ai,javascript,llm,sandbox,v8,wasm,webassembly
GitHub 星标★ 4866
上线时间2024-02-07 00:00:00
代码更新2026-11-08
仓库体积593.4 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4866

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门 约 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

上一篇：axonhub

下一篇：optillm

同类项目推荐

oomstore 开源

用 Go/Rust 打造的高速特征仓库，让特征上线快如闪电

Lightweight and Fast Feature Store Powered by Go (and Rust).

★ 91 2026-08-09
headroom 开源

喂给 AI 之前先瘦身，每五次对话省一次钱

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fe···

★ 79198 2026-08-09
mistral-inference 开源

官方推理库，快速跑通 Mistral 模型，省心部署

Official inference library for Mistral models

★ 10819 2026-08-09
feature-store 开源

打通数据与模型，让特征复用不再重复造轮子

Using a feature store to connect the DataOps and MLOps workflows to enable collabora···

★ 62 2026-08-09
production-stack 开源

把 vLLM 单机推理一键扩成 K8S 集群生产服务

vLLM’s reference system for K8S-native cluster-wide deployment with community-drive···

★ 2720 2026-10-14
router 开源

换一个端点，50 毫秒内自动选对模型，成本直降 70%

Model router for agentic systems. Routes every prompt to the right model in <50ms. C···

★ 5615 2026-08-09
great_expectations_action 开源

在CI中一键验证数据质量，让数据管道更可靠

A GitHub Action that makes it easy to use Great Expectations to validate your data p···

★ 86 2026-08-09
gpu-hot 开源

打开网页，实时盯紧每一块 NVIDIA GPU 的状态

Real-time NVIDIA GPU dashboard

★ 1643 2026-08-09
desktop 开源

给 AI 一个安全的桌面环境，让它放心操作电脑

E2B Desktop Sandbox for LLMs. E2B Sandbox with desktop graphical environment that yo···

★ 1558 2026-08-09