rivet:基于多语言生态的长运行轻量级有状态进程框架项目

面向智能体工作负载的高性能、高密度、可扩展编排引擎。

Rivet Actors 是为智能体、工作流和沙箱打造的持久化进程。
6.9 ms 冷启动，单 Actor 仅占 72 KB，单一控制平面支撑数十亿实例。
一个 Rust 二进制文件加一个存储桶，无需数据库，无需消息队列。开源且支持自托管。

快速开始 • 文档 • 更新日志 • Discord • X

快速入门

npx skills add rivet-dev/skills

什么是 Rivet？

Rivet 是一个面向智能体工作负载的编排引擎。Kubernetes 调度 Pod，而 Rivet 调度 Actor：具有持久化状态的长生命周期进程，每个 Actor 自带 SQLite 数据库、消息队列、实时连接和调度能力，并通过唯一键进行寻址。

每个智能体、每个会话、每个用户或每个租户对应一个 Actor。运行在原生 Node.js、Bun 或 Rust 之上。开源且支持自托管。

• 每个 Actor 仅占 72 KB：Actor 运行在你已有的节点进程内，而非独立的容器或虚拟机。一台能承载数百个 Pod 的服务器，可以承载数十万个 Actor。
• 6.9 ms 冷启动：冷启动包含 Actor 调度、存储创建及首个请求的响应，无需拉取镜像，无需容器启动。
• 单一控制平面支撑数十亿 Actor：Actor 独立调度，扩展容量只需增加机器。同一个控制平面既能运行一千个 Actor，也能运行十亿个。
• 空闲休眠，按需唤醒：空闲 Actor 会将状态写入磁盘并卸载，下一次请求在 4.4 ms 内将其恢复，状态无损。
• 状态随 Actor 绑定：每个 Actor 拥有独立的 SQLite 数据库和键值存储。控制平面在确认写入前会将数据复制到多个实例的磁盘上，随后在后台将数据迁移至对象存储。存储空间永不耗尽，对象存储也不在写入路径上。
• 一个 Rust 二进制加一个存储桶：无需运行数据库，无需消息总线。控制平面实例完全对等，各自运行全部服务，通过存储桶互相发现。
• 运行时执行 Agent 生成的代码：每段新的、不可信的代码都会获得一个独立的 Actor，拥有自己的数据库和文件系统，无法访问其他 Actor 的资源。
• 兼容你现有的工具链：后端提供类型安全的 SDK，前端提供 React Hooks。无需自定义运行时，你现有的依赖包、工具链和测试无需任何改动即可使用。

后端

import { actor } from "rivetkit";
import { db } from "rivetkit/db";

const agent = actor({
  // Per-Actor SQLite database, persisted across restarts and hibernation
  db: db({
    onMigrate: async (db) => {
      // Apply the SQLite schema
      await db.execute(`CREATE TABLE IF NOT EXISTS messages (role TEXT, content TEXT)`);
    },
  }),

  actions: {
    chat: async (c, text: string) => {
      // Durably save the message
      await c.db.execute("INSERT INTO messages VALUES (?, ?)", "user", text);
      const messages = await c.db.execute("SELECT role, content FROM messages");

      const response = streamText({ model: openai("gpt-5"), messages });

      // Stream tokens to every connected client for multiplayer
      for await (const delta of response.textStream) {
        c.broadcast("token", delta);
      }

      // Durably save the response
      await c.db.execute("INSERT INTO messages VALUES (?, ?)", "assistant", await response.text);
    },
  },
});

客户端（前端或后端）

// Connect to an Actor
const agent = client.agent.getOrCreate("agent-123").connect();

// Listen for realtime events
agent.on("token", delta => process.stdout.write(delta));

// Call an action on the Actor
await agent.chat("how many r's in strawberry?");

Actor 类型

Rivet 推出的每一款产品都是一个 Actor，由同一个控制平面统一调度。

• Actors：长驻进程，内置状态管理、实时通信和调度能力。
• Agents：每个 Agent 对应一个持久化进程，记忆可在重启后保留。
• Workflows：多步骤操作，失败后从断点重放而非从头开始。
• Sandboxes (agentOS)：为未编写的代码提供文件系统、Shell 和网络环境。
• Dynamic Apps（预览版）：为每个用户生成独立后端，生成即部署。

为 Agent 的一切需求而生

• 编码 Agent：每个 Agent 对应一个 Actor，拥有持久化进程、沙箱环境，状态可在重启后保留。
• Agent 应用构建器：你的产品为每位用户生成一整套后端，每一个都作为独立 Actor 部署，并支持缩容至零。
• 企业专属 Agent：在 VPC 内部署 Agent，与 Postgres、自有 API 和客服系统同处一个网络，数据不出你的云环境。
• 个人 Agent：每位用户拥有一个长驻 Actor，具备记忆、调度和提醒能力，可在线运行数月。
• 实时应用：每个文档、房间或频道对应一个 Actor，将变更广播给所有已连接的客户端。

Actor 与 Kubernetes 的对比

特性

路由、调度、类型系统与遥测，开箱即用。

• 天生容错：节点宕机时，其上的 Actor 会被重新调度到其他节点，状态完整保留。无需自建重放机制或检查点。
• 每个 Actor 自带状态：每个 Actor 都拥有独立的 SQLite 数据库和键值存储。控制平面负责写入复制并将数据同步到对象存储，你无需为 Actor 预估磁盘容量。
• 多区域部署：将 Actor 部署在它所服务的用户和数据附近，请求会自动路由到 Actor 当前所在的位置。
• HTTP 与 WebSocket 网络：通过 HTTP 直接寻址 Actor，或与其保持实时 WebSocket 连接。中间无需队列或消息代理。
• 端到端类型安全：Actor 定义会自动生成对应的客户端类型，签名变更会在编译阶段报错，而非在生产环境才暴露。
• React SDK：官方提供的一等 Hooks，将组件订阅到 Actor 的状态，Actor 更新时自动保持同步。
• OpenTelemetry 与可观测性：以 OTel 格式输出链路追踪、指标和结构化日志，直接接入你现有的 Collector。
• 单一 Rust 二进制：控制平面以单一静态二进制文件交付。在负载均衡器后面运行几个相同实例，配合一个对象存储桶即可——无需先搭建数据库或消息总线。
• Cron 与调度：按定时计划唤醒 Actor，或由 Actor 自行设定时间戳触发，无需独立的调度器。
• 空闲即休眠：空闲的 Actor 会释放资源，下一个请求到来时带着持久化状态醒来。
• Actor 间调用：Actor 之间通过 key 互相寻址，跨集群调用如同调用本地 Actor 一样。
• 无需 Kubernetes Operator：负载均衡器后面一个控制平面，在你的 VPC 内通过纯 HTTP 通信。没有 CRD，没有 Operator，没有需要维护的 Service Mesh。
• 开源：Apache 2.0 协议，支持完整自托管。托管服务运行的正是你可以自行运行的同一套控制平面。

部署方式

npm install rivetkit@next

所有方案运行的是同一个二进制文件，唯一的区别是谁来运维。 自托管意味着运行四个组件：相同的控制面实例（试用一个即可，生产环境需三个或以上）、每个实例一块持久化磁盘（用于存储最近的写入数据和实例身份）、每个集群一个存储桶（支持 S3、Google Cloud Storage、Azure Blob Storage 或任何兼容 S3 的存储），以及运行你的 Actors 的节点。无需运行数据库，也无需消息队列。本地开发与生产环境完全一致：从笔记本电脑到生产环境，相同的二进制文件、API 和控制面行为。

开源，宽松许可：Apache 2.0 意味着你的基础设施完全归你所有。托管服务运行的控制面与你自行部署的完全相同。与工程师交流 →

与你现有工具无缝集成

后端提供类型化 SDK，前端提供 React Hooks。Rivet 原生运行于 Node.js 和 Bun，无需自定义运行时，因此你现有的依赖包、工具链和测试无需任何改动即可正常工作。

节点部署方式：Docker Compose • Kubernetes • VM 与裸金属 • Hetzner • AWS ECS • Railway • Render

框架：React • Next.js • Hono • Elysia • tRPC • Effect

运行时：Node.js • Bun • Rust

工具：Vitest • OpenTelemetry • Pino • AI SDK • OpenAPI • AsyncAPI

申请集成支持 →

常见问题

本仓库中的项目

社区

• Discord - 与社区交流
• X/Twitter - 关注获取最新动态
• Bluesky - 关注获取最新动态
• GitHub Discussions - 提问
• GitHub Issues - 报告问题
• Talk to an engineer - 讨论你的使用场景

许可证

Apache 2.0