NodeAktDistributed Actor framework for TypeScript

Typed actors, supervision, behaviors, a multi-core runtime, remoting, and clustering across nodes. Zero dependencies. No locks, just messages.

Guide

GitHub

Runtime

Actors, on one machine.

An actor owns private state and a mailbox. The runtime delivers one message at a time, so that state needs no lock.

One message at a timeAn actor owns private state and a mailbox. The runtime delivers one message at a time, so that state needs no lock.Read
Typed messagesMessages are classes narrowed with instanceof. tell is fire-and-forget; ask waits for a reply.Read
SupervisionStop, resume, restart, or escalate on failure. One-for-one or one-for-all, restart budgets, exponential backoff.Read
Behaviors and stashbecome and becomeStacked swap the handler at runtime; the stash replays deferred messages after a switch.Read
MailboxesUnbounded and bounded FIFO, segmented, fair per-sender, and priority. Or implement your own.Read
Pipe, request, schedulepipeTo turns a promise's result into a message, reentrant requests keep the mailbox moving while a reply is in flight, and schedules deliver on a delay or an interval.Read
Multi-coreSpawn with Props and the runtime places actors across every core. Same PID API locally and across isolates.Read

Networking

Look up, spawn, and message actors on another node. TLS encrypts the carrier when you need it; enabling it hinders performance versus plaintext.

Clustering

Actors, across many machines.

Turn a set of nodes into one cluster. Spawn, address, and message actors by name across the cluster, and have a departed node's actors recreated on the survivors automatically.

Zero dependencies

The whole library is built on the standard library alone. npm install brings exactly one package.