tractor/docs/start/index.rst

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

Already installed and itching? Jump straight to /start/quickstart; once you're through the on-ramp the guide pages </guide/index> take each subsystem deeper.