Durable Actors: OSS Alternative to Cloudflare Durable Objects

Original title: Show HN: Durable Actors – OSS Durable Objects with configurable compute
68AI Score

Durable Actors launches as an open-source alternative to Cloudflare Durable Objects, offering configurable compute and no vendor lock-in. By defining Actors with durable state and serialized execution, it simplifies building distributed apps like chat systems and agent swarms, featuring built-in memory limits and observability.

Full Report

Contents6 sections

Cloudflare Durable Objects 的开源替代方案……无供应商锁定、无内存限制,并内置可观测性。

Durable Actors 助你构建实时应用,例如聊天系统(如 ChatGPT、Codex)、协作工具(如 Notion)以及智能体集群(如 Devin)。

它们提供 有状态的 Serverless 函数,这是一种基础构建块,抽象了分布式系统中的持久化、协调和基础设施挑战。

在线演示 · TypeScript 文档 · Python 文档

工作原理

  1. 定义一个 actor,它是一个类,具备 durable state(即数据在中断、错误和重启后依然存活)和 serialized execution(即并发调用者可以安全地更新它)。 例如:
  • 如果你正在构建 ChatGPT... 一个聊天 actor 可以存储对话记录,即使 LLM 不稳定或服务器崩溃也能保留数据(durable state)
  • 如果你正在构建 Notion... 一个文档 actor 可以协调来自多人和多个 agent 的并发编辑(serialized execution)
  1. 使用 Durable Actors SDK 自动生成类型安全的客户端。目前支持 Python 和 TypeScript。
  2. 通过一条命令进行本地开发,随后可以 在 GCP 上自托管 Durable Actors 运行时。

快速开始:多人 AI 聊天

队友跨地区共享同一个 TeamAgent 聊天;提示词排队处理,回复流式发送给所有人,且对话状态被持久化保存。

1. 创建项目

安装 Node.js 22.19+ 和 Bun 1.3.9+。

BASH
npx durable-actors init my-actors
cd my-actors
npm install
npx durable-actors dev # 在你的机器上本地运行服务器

2. 定义一个 actor

在你的 actor 项目的 src/actors.ts 中定义并导出 actors,这是 durable-actors dev 加载的默认入口点。运行时按需加载 actors,并持久化标记为 @Persisted 的字段。

例如,一个聊天记录 actor:

TYPESCRIPT
import { openai } from "@ai-sdk/openai"
import { streamText } from "ai"
import { Actor, type ActorSocket, Interleave, Persisted } from "durable-actors"

type Message = { role: "user" | "assistant"; content: string }

export class ChatHistory extends Actor<null, string, Message[]> {
    @Persisted messages: Message[] = []

async onConnect(socket: ActorSocket<null, Message[]>) {
        socket.send(this.messages)
    }

@Interleave // 在 await 期间允许其他调用运行,例如在回复流式传输时处理新连接。
    async onMessage(_socket: ActorSocket<null, Message[]>, text: string) {
        this.messages.push({ role: "user", content: text })
        const result = streamText({ model: openai("gpt-5-mini"), messages: [...this.messages] })
        const reply: Message = { role: "assistant", content: "" }
        this.messages.push(reply)
        this.broadcast(this.messages)
        for await (const chunk of result.textStream) {
            reply.content += chunk
            this.broadcast(this.messages)
        }
    }
}

3. 连接你的后端

我们让将 actors 集成到你现有的技术栈中变得极其简单。只需生成客户端,即可获得一个完全类型安全的交互契约。

BASH
npx durable-actors generate

创建一个 WebSocket 连接到共享聊天室:

TYPESCRIPT
import express from "express"

import { actors } from "../generated/index.js"

export const app = express()

app.post("/api/chat/socket", async (_req, res) => {
    const grant = await actors.ChatHistory.prepareWebsocket({
        actorId: "lobby",
        metadata: null
    })
    res.set("Cache-Control", "no-store").json(grant)
})

4. 连接前端

TSX
import { useEffect, useRef, useState } from "react"
import { createRoot } from "react-dom/client"

import type { actors } from "../generated/index.js"

function Chat() {
    const socket = useRef<WebSocket>(null)
    const [messages, setMessages] = useState<actors.ChatHistory.Outgoing>([])

useEffect(() => {
        let active = true
        async function connect() {
            const response = await fetch("/api/chat/socket", { method: "POST" })
            const { websocketUrl } = await response.json()
            if (!active) return
            socket.current = new WebSocket(websocketUrl)
            socket.current.onmessage = event => setMessages(JSON.parse(event.data))
        }
        void connect()
        return () => {
            active = false
            socket.current?.close()
        }
    }, [])

function send(form: FormData) {
        const text = String(form.get("message")).trim()
        if (!text || socket.current?.readyState !== WebSocket.OPEN) return
        socket.current.send(JSON.stringify(text))
    }
Text
    <main>
        <div role="log" aria-label="Messages">
            {messages.map((message, index) => (
                <p key={index}><strong>{message.role}:</strong> {message.content}</p>
            ))}
        </div>
        <form action={send}>
            <input name="message" aria-label="Message" required />
            <button>Send</button>
        </form>
    </main>
)

}

createRoot(document.getElementById("root")!).render(<Chat />)

Text

如需包含错误处理和重试机制的完整应用,请参阅 [AI Chat 示例](/ai-chat)。

### 5. 监控与调试

Durable Agents 提供了内置的可观测性功能:

![o11y-screenshot](/api/v1/file/hot_img_4e6b85bbfc13b57dd33a08f7b9f8acdf.webp)

## 示例

如需完整的示例应用程序,请参阅 [AI Chat](/ai-chat)、[协作文档](/documents) 和 [聊天室](/chat)。

## 社区

欢迎提交 Bug 报告、功能请求、文档修正以及代码贡献。有关仓库设置和检查项,请参阅 [贡献指南](CONTRIBUTING.md),并遵守我们的 [行为准则](CODE_OF_CONDUCT.md)。

请使用 [GitHub Issues](https://github.com/TerseAI/durable-actors/issues) 反馈 Bug、想法和问题。请通过我们的 [安全政策](SECURITY.md) 私下报告漏洞。

在 [GitHub Releases](https://github.com/TerseAI/durable-actors/releases) 上关注开发进展和发布说明。

---
**作者发帖说明(HN)**:

大家好,我是来自 Terse ([https://www.useterse.ai/](https://www.useterse.ai/)) 的 Thomas 和 Olivier。我们构建了 Durable Actors,这是 Cloudflare Durable Objects 的一个开源替代方案。

Durable Object/Actor 是一个微型服务器,每次只处理一个请求,并拥有自己的 SQLite 数据库。世界上每个这样的对象都是唯一的,并通过名称进行寻址。

这是部署多人智能体(agents)的理想基础组件。每个智能体可以拥有自己的 Durable Actor,每个用户都可以通过 websocket 连接到该 Actor。这实现了完全的横向扩展。用户可以随意部署和共享智能体,而不会给中央数据库或 websocket 服务器带来压力。

Durable Actors 也非常适合协调系统内的多个智能体。由于每次只处理一个请求,你可以保护诸如 CRM 等关键数据,并允许多个智能体并发运行,而无需担心数据竞争问题。

唯一的替代方案是 Cloudflare 的 Durable Objects。然而,它存在严重的供应商锁定问题(会将你绑定到 D1、R2 + Workers 生态系统中),而且五年前发布时并非专为智能体工作负载设计。

基于 Durable Objects 构建的一些知名项目包括 RampInspect、OpenInspect,以及多人协作框架 Liveblocks 和 PartyKit。现在你可以使用 Durable Actors 来构建此类项目。

Durable Actors 是一个专为并发智能体工作负载设计的 DO 版本。它完全开源(采用 MIT 许可证),并包含一个 Helm chart f...