Developer Guides
These guides walk you through everything from your first workflow to production-grade distributed systems. Whether you're building background jobs, data pipelines, or multi-service orchestrations, you'll find patterns and examples in Rust, TypeScript, and Python.
Getting Started
New to Orcher? Start here to get up and running quickly.
Quickstart Install Orcher, write your first workflow, and run it locally in under five minutes.
Local Development Set up your development environment with hot reload, local server, and debugging tools.
Core Features
Learn the fundamental building blocks that power every Orcher application.
Understanding Orcher How Orcher's execution model works — journaling, deterministic replay, and durable state.
Building Workflows Define workflows that survive crashes, restarts, and deployments. Compose sequential and parallel steps with automatic checkpointing.
Defining Tasks Write the units of work that workflows execute — with retries, timeouts, and type-safe inputs/outputs.
Automatic Journaling Understand how Orcher records every step so workflows can resume exactly where they left off.
Managing State Work with workflow state, side effects, and deterministic execution constraints.
Actors Build stateful, keyed entities with per-instance state and single-writer concurrency. Ideal for shopping carts, counters, sessions, and device twins.
Handling Events Send and receive events between workflows, implement human-in-the-loop approvals, and coordinate across services.
Dealing with Errors Configure retries, compensation logic, and failure handling strategies for robust applications.
Developer Patterns
Proven architectural patterns for common distributed systems challenges.
Parent-Child Orchestration Compose complex workflows from reusable child components. Coordinate distributed services and build hierarchical orchestration trees.
Saga & Compensation Implement distributed transactions with the saga pattern and compensating actions. Ensure data consistency across multiple services without distributed locks.
Fan-Out/Fan-In Split work across multiple parallel operations and aggregate results. Batch processing, multi-service calls, and data aggregation.
Long-Running Processes Build workflows that span hours, days, or weeks. Handle human approvals, scheduled operations, and multi-stage business processes.
Use Cases
End-to-end examples showing how Orcher solves real-world problems.
Data Pipelines & ETL Build reliable extract-transform-load pipelines with automatic retries, checkpointing, and parallel processing.
Payment Workflows Implement payment processing, refunds, and financial reconciliation with saga-based consistency guarantees.
Service Orchestration Coordinate multiple microservices with child workflows, saga rollback, event gates, and parallel fan-out patterns.
Background Jobs Run email campaigns, scheduled reports, content processing, and other async workloads with batching and rate limiting.
Event Processing Build event-driven order pipelines, stateful actors, windowed aggregation, and pattern detection workflows.
SDK & CLI Reference
Rust SDK · TypeScript SDK · Python SDK · CLI Reference
Operations
Observability · Deployment · Security · Logging