Getting started

Welcome aboard B)

Real talk before any code: the first step to grok tractor is to get an intermediate knowledge of trio and structured concurrency (SC). tractor is just trio - but with nurseries for process management and cancel-able streaming IPC - so every rule you already know about task lifetimes, cancellation and error propagation keeps holding, just now across process (and host!) boundaries. Some great places to start are,

• the seminal blog post,

• obviously the trio docs,

• wikipedia’s nascent SC page,

• the fancy diagrams @ libdill-docs.

Once you’ve taken in (some of) the canon, get installed and go spawn your first actor tree:

• Install
• Quickstart

See also

Already installed and itching? Jump straight to Quickstart; once you’re through the on-ramp the guide pages take each subsystem deeper.