Build AI Actors 🎭

Write Python functions, deploy as Kubernetes actors, chain into meshes.

Getting Started

Build and deploy your first actors:

First Actor — Build an echo actor, deploy, send a message, verify the result
First Actor Mesh — Chain two actors via route.next, trace the envelope at each hop
First Flow — Write a Flow DSL file, compile, inspect generated routers, deploy

Patterns and techniques for actor development:

Handler Patterns — Adapter pattern, generator vs function handlers, typed outputs
Agentic Patterns — Fan-out, dynamic routing, conditional branching, streaming
Streaming — FLY events, SSE, live progress to gateway clients
Actor Flavors — Choose and use flavors in actor specs
State Proxy — Read/write /state/ paths in handlers
Pause/Resume — Yield SET to x-pause, handle resume input
Timeouts — Set actorTimeout, understand deadline behavior
Error Handling — try/except in flows, error routing, finally blocks
Compiler Rules — Extend the compiler with custom rules for decorators, context managers, and calls

Debugging — Trace envelopes by trace_id, curl the runtime, check x-sink/x-sump