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

Rivet Actors 是有状态工作负载的基础组件。

专为 AI 智能体、协作应用和持久化执行打造。

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

什么是 Rivet？

Rivet Actors 是为有状态工作负载设计的长时间运行、轻量级进程。状态驻留在内存中并具有自动持久化能力。可针对每个智能体、每个会话或每个用户创建一个 Actor，并内置工作流、队列和调度功能。

后端

const agent = actor({
  // In-memory, persisted state for the actor
  state: { messages: [] as Message[] },

  // Long-running actor process
  run: async (c) => {
    // Process incoming messages from the queue
    for await (const msg of c.queue.iter()) {
      c.state.messages.push({ role: "user", content: msg.body.text });
      const response = streamText({ model: openai("gpt-5"), messages: c.state.messages });

      // Stream realtime events to all connected clients
      for await (const delta of response.textStream) {
        c.broadcast("token", delta);
      }

      c.state.messages.push({ role: "assistant", content: 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));

// Send message to actor
await agent.queue.send("how many r's in strawberry?");

特性

每个智能体、每个会话、每个用户对应一个 Actor——内置状态、存储和网络功能。

Rivet 提供：

• 内存状态 — 与计算紧密结合，支持即时读写。可通过 SQLite 或自定义数据库实现持久化。
• 无限期运行，闲置时休眠 — 活跃时长期运行，闲置时自动休眠。
• 无限扩展，零资源扩展 — 支持突发工作负载，兼具成本效益。
• 全球边缘网络 — 轻松在用户附近或特定法律管辖区部署，无需复杂配置。

Actors 支持：

• WebSockets — 内置实时双向流传输。
• 工作流 — 带自动重试机制的多步骤操作。
• 队列 — 用于可靠异步处理的持久化消息队列。
• 调度 — Actor 内部的定时器和 cron 任务。

应用场景

一个基础组件，可适应智能体、工作流、协作等多种场景。

• AI 智能体 — 每个智能体作为独立 Actor 运行，拥有持久化上下文、内存及工具调用调度能力。
• 沙箱编排 — 为每个工作区分配一个长期运行的 Actor，负责协调沙箱会话、任务排队和清理调度。
• 工作流 — 多步骤操作，跨步骤自动重试、调度和持久化状态。
• 协作文档 — 实时协作编辑，每个文档作为一个 Actor，向所有连接用户广播变更。
• 租户专属数据库 — 每个租户一个 Actor，提供低延迟内存读取和持久化租户数据存储。
• 聊天 — 每个房间或对话一个 Actor，具备内存状态、持久化历史记录和实时消息传递功能。

Actors 对比

Rivet Actors 与传统基础设施对比

状态对比

内置可观测性

从本地开发到大规模生产环境，提供强大的调试与监控工具。

• SQLite 查看器 — 实时浏览和查询 Actor 的 SQLite 数据库
• 工作流状态 — 执行过程中检查工作流进度、步骤和重试情况
• 事件监控 — 实时跟踪每一次状态变更和操作
• REPL — 调用操作、订阅事件并直接与代码交互

部署选项

RivetKit 是一个库。需要扩展、容错和可观测性时，可将其连接到 Rivet Cloud 或进行自托管。

npm install rivetkit

docker run -p 6420:6420 rivetdev/engine

开源且采用宽松许可——自托管对于企业部署、云服务可移植性以及避免供应商锁定至关重要。Apache 2.0 许可意味着您拥有自己的基础设施。在 GitHub 上查看 →

快速开始

npx skills add rivet-dev/skills

集成

无论是无服务器架构、容器还是您自己的服务器，Rivet Actors 都能与您现有的基础设施、框架和工具协同工作。

基础设施：Vercel • Railway • AWS • Docker

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

运行时：Node.js • Bun • Deno

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

请求集成 →

本仓库中的项目

社区

• Discord - 与社区交流
• X/Twitter - 关注获取更新
• Bluesky - 关注获取更新
• GitHub Discussions - 提问交流
• GitHub Issues - 报告缺陷
• Talk to an engineer - 讨论您的使用场景

许可证

Apache 2.0