Skip to main content

distribute decorator

The eugo.hpc decorator that turns a function into a distributed task, or a class into an actor. Call a decorated function with .remote() to get a future.

It is applied once, at the definition site. The call site adds .remote(...), which starts the work and returns a future; calling the function directly raises a TypeError that points to .remote().

SDK & APIDistributed compute

Related terms

  • Task: One unit of distributed work: a single .remote() call to a function decorated with the distribute decorator. Tasks are stateless, so each call starts fresh.
  • Actor: A distributed object that holds state across many calls. Created by applying the distribute decorator to a class rather than a function.
  • Future: A handle to a result that does not exist yet. Calling a distributed function with .remote() returns a future immediately, while the work happens elsewhere.
  • eugo.hpc: The Python module holding Eugo’s distributed-compute API. The top-level eugo namespace is deliberately empty; everything lives under eugo.hpc.
  • options(): The method that sets per-call resource requirements on a distributed function, such as num_cpus or num_gpus.