Skip to content
Cloacina
Search
Ctrl
K
Cancel
GitHub
Select theme
Light
Dark
Hyper
Auto
Menu
Start Here
Start Here
Embed the Library
Run the Service
Engine & Primitives
Tutorials
Embed the Library
Overview
01 — Your First Workflow
Quick Start
02 — Passing data with Context
03 — Dependencies & parallelism
04 — Error handling & retries
05 — Cron Scheduling
06 — Multi-Tenancy
07 — Event Triggers
08 — Task Deferral
09 — Working with the Workflow Registry
10 — Your First Computation Graph
11 — Accumulators
12 — Full Multi-Source Pipeline
13 — Routing and Enum Dispatch
14 — Packaged Triggers
Run the Service
Overview
Quick Start
01 - Deploy a Server
02 - The Web UI
03 — Packaged Workflows
04 — Packaging a Computation Graph
05 — WebSocket Event Injection
06 — Kafka-Sourced Computation Graphs
07 — Cross-Package Reactor Binding
How-to guides
Installing cloacinactl
Embed the Library
Overview
Testing Workflows
Running embedded in production
Subscribe a workflow to a reactor
Declare and validate workflow inputs
Invoke a computation graph from a workflow task
Configure a Database Connection URL
Conditional Retries
Observe Execution State
Performance Optimization
Packaging Python Workflows
Running the Daemon
Monitoring Executions
Variable Registry (var/var_or)
Cleaning Up Events
Run the Service
Overview
Creating Your First Package
Manage API Keys
Safely Unload a Package
Configure a Multi-Tenant Deployment
Configure Local Accounts
Manage Secrets
Configure OIDC Single Sign-On
Use cloacina-compiler Locally
Run cloacina-compiler in Production
Multi-Tenant Recovery
Production Deployment
Back Up and Restore
Configure PostgreSQL Schema-Based Multi-Tenancy
Embedded Web UI
Performance Tuning
Security
Overview
Package Signing
Local Development
Deploying the API Server
Migrating from Library to Service Mode
Running the cloacina-server Docker image
Deploying to Kubernetes (Helm)
Deploy an Execution-Agent Fleet
Compiler + Server Deployment Runbook
Deploy the Web UI
Decommission a tenant
Require signed packages
Use CLI profiles
Workflows
Overview
Build Workflows with WorkflowBuilder
Use Secrets in a Workflow
Computation Graphs
Overview
Package a Python Computation Graph
Choosing and Using Accumulator Types
Filter Reactor Subscriptions (Python)
Monitoring Computation Graph Health
Manually Driving Graph Surfaces
Computation Graph in a Workflow Task
Triggering Workflows from Reactor Firings
Using when_all Reaction Criteria
Filter reactor firings with CEL
Using Sequential Input Strategy
Constructors & Providers
Author a Constructor Provider
Consume a Constructor Provider
Reference
Overview
CLI Reference
HTTP API Reference
Configuration Reference
Macro Reference
Error Reference
Python Environment Variables
Repository Structure
Topology Dict Schema
API Error Envelope
Metrics Catalog
DatabaseAdmin API Reference
Package Signing API Reference
Environment Variables
cloacina-testing API Reference
package! Macro Reference
FFI Vtable Reference
API Reference
Overview
Python
cloaca
Rust
cloacina
Overview
computation_graph
Overview
accumulator
embedded
global_registry
graph_executor
packaging_bridge
reactor
reactor_lock_key
reactor_ownership
reactor_routing
registry
scheduler
stream_backend
triggerless
types
context
cron_evaluator
cron_recovery
cron_trigger_scheduler
crypto
Overview
envelope
key_encryption
signing
dal
Overview
filesystem_dal
Overview
workflow_registry_storage
unified
Overview
agent_desired
agent_limits
api_keys
Overview
crud
checkpoint
context
delivery_outbox
execution_event
fleet_agents
local_accounts
login_throttle
models
oidc_login_flows
oidc_sessions
reactor_owner_addresses
reactor_subscriptions
recovery_event
schedule
Overview
crud
schedule_execution
task_execution
Overview
claiming
crud
queries
recovery
state
task_execution_metadata
workflow_execution
workflow_packages
workflow_registry_storage
ws_tickets
database
Overview
admin
connection
Overview
backend
schema_validation
universal_types
delivery
Overview
envelope
sweeper
dispatcher
Overview
default
traits
types
error
execution_planner
Overview
context_manager
scheduler_loop
stale_claim_sweeper
state_manager
trigger_rules
executor
Overview
context_builder
deferral_registry
host_impl
result_handler
slot_token
task_handle
thread_task_executor
types
workflow_executor
fleet
Overview
protocol
graph
input_interface
inventory_entries
logging
models
Overview
context
delivery_outbox
execution_event
key_trust_acl
package_signature
recovery_event
schedule
signing_key
task_execution
task_execution_metadata
trusted_key
workflow_execution
workflow_packages
workflow_registry
packaging
Overview
constructor_provider
platform
provider_bundle
types
validation
python_runtime
registry
Overview
error
loader
Overview
constructor_loader
ffi_trigger
ffi_triggerless_graph
grants
package_loader
task_registrar
Overview
dynamic_task
extraction
types
reconciler
Overview
loading
storage
traits
types
workflow_registry
Overview
database
filesystem
package
retry
runner
Overview
default_runner
Overview
config
cron_api
reactor_subscriptions_api
service_manager
services
workflow_executor_impl
workflow_result
runtime
security
Overview
api_keys
audit
db_key_manager
fleet_secret
key_manager
package_signer
secret_resolver
secret_store
verification
task
Overview
namespace
tenant_scope
trigger
var
workflow
Overview
builder
graph
metadata
registry
workflow_instance
cloacina-computation-graph
cloacina-python
Overview
bindings
Overview
admin
context
runner
trigger
value_objects
Overview
retry
computation_graph
constructor
context
gil
import_guard
loader
namespace
package_loader
reactor
registration_scope
runtime_impl
runtime_scope
task
trigger
trigger_rules
workflow
workflow_context
cloacina-workflow
Overview
context
cron_evaluator
error
input_interface
namespace
retry
secret
task
trigger
Computation Graph Reference
SDKs
Overview
Rust SDK
Python SDK
TypeScript SDK
WebSocket Protocol
API Reference
Overview
Context
DefaultRunner
WorkflowBuilder
Database Admin
Task Decorator
Computation Graphs
Trigger Decorator
Workflow
Configuration
WorkflowResult
Exceptions
Package Manifest
Glossary
Troubleshooting
Explanation
What is Cloacina?
Is Cloacina for you?
Concepts
Features Overview
Embed the Library
Overview
Python Runtime Architecture
Workflow Performance and Design Trade-offs
Run the Service
Overview
Reconciler Pipeline
Database Backends
Security Model
Secrets
Horizontal Scaling
Observability
Execution-Agent Fleet
Multi-Tenancy Architecture
Performance Characteristics
Engine
Overview
Architecture Overview
Workflow Versioning
Context System
Trigger Rules
Macro System
Computation Graph Architecture
Python CG Decorator Surface
Accumulator Design
Inventory and Runtime Seeding
Package Format
FFI System
Packaged Workflow Architecture
Guaranteed Cron Scheduling
Reactor Lifecycle
Trigger-less Computation Graphs
Packaging & FFI
Task Execution
Task Deferral
Dispatcher Architecture
Graph Scheduling
Performance Characteristics
Subscription fan-out
Cron Scheduling Architecture
Primitives
Workflows
Overview
Workflow
Task
Context
Runner
Computation Graphs
Overview
Computation Graph
Node
Reactor
Accumulator
Boundary event
Scheduling & Triggers
Overview
Workflow Instances
Trigger
Cron schedule
Packaging
Overview
Package
Constructors & Providers
Overview
Capability Grants
Seed Providers
Contributing
Overview
Documentation
GitHub
Select theme
Light
Dark
Hyper
Auto
Security
Guides for securing your Cloacina deployment.
Package Signing
Local Development