Built for real life

Palm gives you the power to build complex workflows that still feel human — with interactive wizards, durable state, and production-grade reliability.

Interactive Wizards

Collection steps, schemas, backtracking, summary & transactional commits. Resume anytime.

Parallel Workflows

Run wizard branches concurrently with isolated scopes and smart merging.

Durable & Reliable

Process instances survive restarts. Outbox, compensation, and live projections keep everything consistent.

Powerful Transforms

22 built-in rules for data shaping, serialization, and enrichment — usable everywhere.

Palm in action

From the living Explorer hub to the rich REPL and live dashboard — see how Palm feels when you run it.

Palm Explorer

Living introspection hub with HTMX wizard workspaces — collection editors, backtrack, progress timelines, and REST-linked instance detail.

Rich REPL Experience

Interactive wizards with numbered choices, backtracking, collection editing, and real-time feedback. Feels alive.

Live Dashboard

Real-time overview of jobs, instances, patterns, and host health. Refresh with -r for monitoring.

Scroll →

Run palm host server and open http://localhost:8080/ to explore live.

Documentation

Architecture, development guides, and the living API reference.

README

Install, quick start, CLI commands, and feature overview.

Architecture

Layers, engines, CQRS, server surfaces, and extension model.

Development

Contributing, testing, type checking, and project conventions.

Pattern Apps

PatternApp manifests, bindings/flow layout, and palm.common boundaries.

Provider Apps

ProviderApp manifests, bindings/flow layout, and the palm compositional provider.

Explorer Wizards (0.13)

Instance workspace at /explorer/instances/{id}, collection UI, and /v1/api/flows session REST. See EXPLORER-WIZARD.md.

REST API

Palm ships a registry-driven HTTP surface on ServerRuntime. Start a server, open Palm Explorer, browse the REST reference, or fetch OpenAPI.

Try it → · GET /explorer — living hub (root redirects here) · GET /v1/docs — interactive reference · GET /v1/openapi.json — OpenAPI 3.0

Start the server

$ palm host server

Default port is 8080. Open http://localhost:8080/ — redirects to Palm Explorer. Health at /health links to Explorer, docs, and OpenAPI.

Endpoint groups

Explorer — SSR hub with wizard workspace and collection UI
Meta — health, OpenAPI, HTML docs
Wizards — instance-keyed submit, status, input, backtrack
Jobs — submit flows, list status, job-level input
Plans — stage and batch-submit execution plans
Instances — durable process index and resume
Snapshots — point-in-time blackboard captures
Catalog — registered flows and processes

List endpoints return a resource array plus a pagination block. When auth_enforce is on, send X-Palm-Subject on write operations.

Try it

Copy these curls against a running server (localhost:8080). Pipe through jq for pretty output.

GET /health

Runtime status and documentation links

curl -s http://localhost:8080/health

GET /v1/jobs/{job_id}/context

Rich job view — wizard step, snapshots, next actions

curl -s 'http://localhost:8080/v1/jobs/job-abc123/context' \
  -H 'Accept: application/json'

GET /v1/jobs

Paginated orchestration job board

curl -s 'http://localhost:8080/v1/jobs?limit=10&offset=0' \
  -H 'Accept: application/json'

POST /v1/jobs

Submit a named flow from the repository

curl -s -X POST 'http://localhost:8080/v1/jobs' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"flow_name":"onboard"}'

GET /v1/instances

Durable process instance index

curl -s 'http://localhost:8080/v1/instances?limit=10&offset=0&include_terminal=true' \
  -H 'Accept: application/json'

GET /v1/instances/{instance_id}/snapshots

State snapshots for audit and replay

curl -s 'http://localhost:8080/v1/instances/inst-abc123/snapshots?limit=10&offset=0' \
  -H 'Accept: application/json'

GET /v1/flows

Registered flow catalog

curl -s 'http://localhost:8080/v1/flows?pattern=wizard' \
-H 'Accept: application/json'

GET /v1/flows/{flow_id}

Full flow definition

curl -s 'http://localhost:8080/v1/flows/onboard' \
-H 'Accept: application/json'

Full reference with every endpoint, schema highlights, and sample responses: GET /v1/docs on your running server.

Start in seconds

$ pip install palmengine[cli]
$ palm                             # REPL cli
$ palm doctor
$ palm status
$ palm flow start onboard          # rich wizard example
$ palm host server                 # http://localhost:8080/explorer

Or with uv (recommended): uvx palmengine palm doctor

Orchestration thatfeels alive