Guides

Task-focused walkthroughs of every major tractor subsystem, each built around real, test-suite verified example scripts from the repo’s examples/ dir (we never copy-paste code into docs; what you read is what CI runs).

Roughly in “first date to long term relationship” order,

• Spawning actors — actor nurseries, daemons + one-shot workers, process lifetimes.

• RPC: calling into other actors — portals: calling into another process like it’s a local await.

• The Context: a cross-actor task pair — the cross-actor task-pair primitive at the heart of modern tractor.

• Cross-process streaming — one-way and bidirectional msg streams between actors.

• Cancellation and error propagation — supervision, error boxing + propagation, teardown discipline.

• “Native” multi-process debugging — the multi-process native REPL debugger; our flagship DX feature B)

• Actor discovery — the registrar, finding actors by name, service patterns.

• Higher-level cluster APIs — quick flat process clusters via one async with.

• Parallelism and worker pools — worker pools without pools; a concurrent.futures re-think.

• Infected asyncio — “infected asyncio” mode: SC-supervise asyncio tasks from trio.

• Typed messaging — typed IPC payloads, the wire msg-spec and custom codecs.

• Testing tips — running + monitoring the test suite (and testing your own actor apps).