Rivet Actors are the primitive for stateful workloads.

Built for AI agents, collaborative apps, and durable execution.

Quickstart • Documentation • Changelog • Discord • X

What is Rivet?

Rivet Actors are long-running, lightweight processes designed for stateful workloads. State lives in-memory with automatic persistence. Create one per agent, per session, or per user — with built-in workflows, queues, and scheduling.

Backend

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 });
    }
  },
});

Client (frontend or backend)

// 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?");

Features

One Actor per agent, per session, per user — state, storage, and networking included.

Rivet provides:

• In-memory state — Co-located with compute for instant reads and writes. Persist with SQLite or BYO database.
• Runs indefinitely, sleeps when idle — Long-lived when active, hibernates when idle.
• Scales infinitely, scales to zero — Supports bursty workloads and is cost-efficient.
• Global edge network — Deploy close to your users or in specific legal jurisdictions without complexity.

Actors support:

• WebSockets — Real-time bidirectional streaming built in.
• Workflows — Multi-step operations with automatic retries.
• Queues — Durable message queues for reliable async processing.
• Scheduling — Timers and cron jobs within your actor.

Use Cases

One primitive that adapts to agents, workflows, collaboration, and more.

• AI Agent — Each agent runs as its own actor with persistent context, memory, and the ability to schedule tool calls.
• Sandbox Orchestration — Coordinate sandbox sessions, queue work, and schedule cleanup in one long-lived actor per workspace.
• Workflows — Multi-step operations with automatic retries, scheduling, and durable state across steps.
• Collaborative Documents — Real-time collaborative editing where each document is an actor broadcasting changes to all connected users.
• Per-Tenant Database — One actor per tenant with low-latency in-memory reads and durable tenant data persistence.
• Chat — One actor per room or conversation with in-memory state, persistent history, and realtime delivery.

How Actors Compare

Rivet Actors vs. Traditional Infrastructure

State

Built-In Observability

Powerful debugging and monitoring tools from local development to production at scale.

• SQLite Viewer — Browse and query your actor's SQLite database in real-time
• Workflow State — Inspect workflow progress, steps, and retries as they execute
• Event Monitoring — Track every state change and action as it happens
• REPL — Call actions, subscribe to events, and interact directly with your code

Deployment Options

RivetKit is a library. Connect it to Rivet Cloud or self-host when you need scaling, fault tolerance, and observability.

npm install rivetkit

docker run -p 6420:6420 rivetdev/engine

Open source, permissively licensed — Self-hosting matters for enterprise deployments, cloud portability, and avoiding vendor lock-in. Apache 2.0 means you own your infrastructure. View on GitHub →

Getting Started

npx skills add rivet-dev/skills