# Orch8 Engine

> A self-hosted, durable workflow orchestration engine built in Rust with a single binary and PostgreSQL or SQLite as the only dependency.

Orch8 Engine is a self-hosted, durable workflow orchestration engine written in Rust that lets you define workflows as composable JSON sequences. It guarantees every step either completes, retries, or surfaces in a dead-letter queue, all from a single binary with one dependency: PostgreSQL (or SQLite for dev/embedded). It is designed as a lightweight alternative to multi-service orchestration stacks like Temporal or Airflow, trading ecosystem breadth for operational simplicity.

- **Workflow Primitives** — *Supports Step, Parallel, Race, TryCatch, Loop, ForEach, Router, SubSequence, CancellationScope, and AB Split blocks for composable sequence design.*
- **Scheduling** — *Offers relative delays, business-days-only scheduling with holiday awareness, timezone-per-instance, jitter, send windows, and cron triggers with configurable tick intervals.*
- **Rate Limiting** — *Per-resource sliding window with deferred scheduling (not rejection), resource pools with weighted rotation, daily caps, and warmup ramps.*
- **Reliability** — *Crash recovery via state snapshots, configurable retry with exponential backoff, dead letter queue, idempotency keys, and circuit breakers with fallback handler routing and persistent state.*
- **Multi-tenancy** — *Tenant-scoped queries, per-tenant rate limits, per-tenant circuit breakers, tenant isolation middleware, and per-tenant noisy-neighbor protection.*
- **AI Agent Support** — *Unified `llm_call` handler covering OpenAI, Anthropic, Gemini, and 7+ more providers; dynamic step injection (self_modify), human-in-the-loop with timeout/escalation, and SSE streaming.*
- **Extensibility** — *External workers in any language via REST long-polling, gRPC sidecar plugins, WASM plugins, webhook events, workflow interceptors, and emit-event with deduplication.*
- **Observability** — *Prometheus metrics, structured JSON logging, audit log, execution tree visualization, and a Grafana dashboard template.*
- **Security** — *AES-256-GCM encryption at rest for context and credentials, OAuth2 credential refresh, API key authentication, and CORS configuration.*
- **Multi-language SDKs** — *TypeScript (authoring + worker), Python, and Go SDKs available; install via npm, pip, or go get respectively.*
- **Deployment Flexibility** — *Deploy via Docker, binary release, Homebrew, or Helm chart; managed cloud option available at cloud.orch8.io.*

## Features
- Single binary deployment
- PostgreSQL and SQLite storage backends
- Durable workflow execution with state snapshots
- Composable JSON workflow sequences
- Parallel, Race, TryCatch, Loop, ForEach, Router, SubSequence, CancellationScope, AB Split primitives
- Business-days-only scheduling with holiday awareness
- Per-resource sliding window rate limiting
- Dead letter queue
- Idempotency keys
- Circuit breakers with persistent state
- Per-entity concurrency key control
- Priority queues (Low/Normal/High/Critical)
- Bulk create/pause/resume/cancel
- Batch instance creation up to 10k
- Multi-tenancy with tenant isolation
- External workers via REST long-polling
- gRPC sidecar plugins
- WASM plugins
- Webhook events
- Unified LLM call handler (OpenAI, Anthropic, Gemini, 7+ more)
- Human-in-the-loop with timeout/escalation
- SSE streaming
- Dynamic step injection (self_modify)
- AES-256-GCM encryption at rest
- OAuth2 credential refresh
- Prometheus metrics
- Structured JSON logging
- Audit log
- Execution tree visualization
- Grafana dashboard template
- 59 documented REST endpoints
- gRPC API
- Cron triggers
- Helm chart for Kubernetes deployment
- React admin dashboard
- 2,028 automated tests

## Integrations
PostgreSQL, SQLite, OpenAI, Anthropic, Gemini, Prometheus, Grafana, Docker, Kubernetes, Helm, Activepieces, TypeScript SDK, Python SDK, Go SDK

## Platforms
WINDOWS, MACOS, WEB, API, DEVELOPER_SDK, CLI

## Pricing
Open Source, Free tier available

## Version
v0.4.0

## Links
- Website: https://github.com/orch8-io/engine
- Documentation: https://orch8.io/docs
- Repository: https://github.com/orch8-io/engine
- EveryDev.ai: https://www.everydev.ai/tools/orch8-engine