Workers
Last updated on October 28, 2026
You can set workers to control the maximum number of phases running in parallel:
execution:
workers: 16TofuPilot runs phases without dependencies (see Depends On) in parallel using a worker pool. It defaults to 8 workers if not specified. Ready phases start in file order.
With the default of 8 workers, independent phases start at the same time. If they talk to the same instrument or link, set workers: 1 to run them one at a time in file order, or chain them with depends_on. A phase that retries goes back in line: with workers: 1, the phases already waiting run before its next attempt. Make the phases after it depends_on it to keep every attempt first.
You can match your CPU core count for CPU-intensive tests. For I/O-heavy tests like instrument communication, you should be able to increase to 2-3x your core count, as workers can overlap while waiting for external devices or user input.
How is this guide?