Guides

Task-oriented walkthroughs for building, governing, and operating Orkestia in your own cloud

Start with a job. Each one ends with something you have done. The cards under it are the longer walkthroughs, for when that job needs the detail.

Start here

Run a workflow from an assistant

Connect an MCP client and watch one run finish.

Connect a cloud and use it

A scoped role, then a workflow that uses the connection.

Put Orkestia in your app

Sign-in first, then data, hosting, or chat.

Stand up an actor

Hire onto a runner you own, and invoke once.

Operate a run

Read a failure, retry it, and open a ticket when code should change.

The concepts section explains what Orkestia is. The rest of this page is how to go further — design workflows with AI, expose them to end-users, provision runners, and run a governed delivery lifecycle — while execution stays inside your cloud accounts.

Orkestia is generally available. Some flows below are still stabilizing; each guide flags its beta surfaces inline. Per-workflow inputs, outputs, and limits live in the external catalog at reference.orkestia.dev.

Core guides

The end-to-end workflows that define day-to-day use of the platform — from AI-driven design to governance and observability.

Building with DGI

Describe an outcome in natural language and let the Dialog Generative Interface reason it into a runnable workflow design.

Staff & Agents

Hire actors, attach agent configs, launch sessions, and oversee the fleet from staff.orkestia.dev.

Agent Exchange

List those actors on the floor, or hire one another org published. Ledger, not funds.

Creating & Exposing Virtual Workflows

Compile DGI-designed or hand-authored compositions into deterministic virtual workflows and publish them for agents and end-users.

Keep scheduled compositions cheap

Start runs from data changes or cron times instead of minute polls, skip empty runs, and read the cost estimate before you activate.

Typed decisions with TypeSafe

Closed-set choice, score, and noul answers in front of compositions, Staff, DGI, and cluster actions. Not a chat model.

Runner Management & Provisioning

Connect, provision, and self-heal the Kubernetes and multi-cloud runners that execute work inside your accounts.

Runner group kinds

Every backend_type (Fargate, EC2, Kubernetes, Azure, GCE, Cloud Run, Droplet, Magalu, DevKit) plus purposes and integrations.

Lumen

Enable observability, mint a key, send data or install the collector, and triage in the Lumen app.

Security & Compliance

Apply the Zero Trust / Zero Code Custody model: keep code and data in your cloud while Orkestia holds only state.

Tickets & Software Delivery

The governed ticket-to-pull-request lifecycle: errors become tickets, plans get acknowledged, and AI coding work lands as verified PRs without agents holding git credentials.

SDKs

Install the Node and Python workflow SDKs, and @orkestia/auth for Sign in with Orkestia.

App Data

Declare tables, read/write through the Data API, expose virtuals to end-users.

Engram

Agent memory, fingerprint, pack recall, live field.

DevKit

Local CLI: hooks, coding runner, ticket sync, compositions.

Platform setup guides

Connect your cloud, deploy the runtime, and wire DNS so the core guides have somewhere to run.

AWS Connections

Establish the cross-account IAM trust that lets Orkestia orchestrate workloads in your AWS accounts without holding credentials.

Cloud Connections

Connect GCP, Azure, Magalu Cloud, and Kubernetes clusters with provider-native grants — same delegation model, no credentials in workflow inputs.

Cloud Deploy

Stand up the Orkestia runtime and runners in your target cloud, following the supported deployment models.

DNS Providers

Configure DNS so end-user surfaces and "Sign in with Orkestia" resolve to your tenant.

Where to start

New to the platform? Run through Getting Started first, then pick the guide that matches your immediate goal. If you are evaluating Orkestia's architecture, read Concepts and the Hybrid Execution Model alongside these guides.

If you want to…	Start with	Then read
Design a workflow from a prompt	Building with DGI	Virtual Workflows
Gate a composition on a typed decision	Typed decisions with TypeSafe	TypeSafe connection
Govern AI agents	Staff & Agents	Staff Governance
Expose workflows to your users	Virtual Workflows	Auth SDK · App Data
Call workflows from code	SDKs	API & tooling
Store app rows without a DSN	App Data	App Enablement
Inspect agent memory	Engram	Write & recall · Field
Local hooks / coding runner	DevKit	Tickets & software delivery
Run work in your own cloud	AWS Connections → Cloud Deploy	Runner Management
Keep tabs on everything	Lumen	Enable · Send data · Query API
Turn production errors into merged fixes	Tickets & Software Delivery	Governance & Approvals

Looking for exact inputs, outputs, and limits per capability? Head to the Reference section and the Workflow Types Registry, or browse the full catalog at reference.orkestia.dev.

Agent Exchange

A labor market for Staff actors — listings, deals, leases, a shared ledger, and settlement on the seller's own payment account

Receive webhooks with a re-query

Point a provider's webhook at a Hook URL, run a composition on each delivery, and act only on what the provider's API confirms. Worked example — Banco Inter Pix and boletos