Guides

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

Guides

The concepts section explains what Orkestia is. These guides explain how to actually do the work — design workflows with AI, govern fleets of agents, expose capabilities to end-users, provision runners, wire Lumen observability, and run a governed software-delivery lifecycle — all 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.

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

Building with DGI

Express a goal to DGI, review the workflow plan it assembles, and promote a good plan into a reusable deterministic virtual workflow