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

Guides#

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

Operations#

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