Skip to main content

Quickstart

Get ECP (Execution Control Protocol) running in a few minutes: install the CLI, author a Fluent workflow, bind an environment, and run.

Prerequisites

  • Node.js 22+
  • npm

Install the CLI

Confirm the binary:
For local monorepo development, see Build from source. Runnable examples live in the core examples tree (echo, accepts/returns, secrets bind, encode/decode, test sessions, invoke).

Run the echo example

From a checkout of the ECP monorepo (after pnpm install and pnpm run build):
Validate without executing:
Compile Fluent/TS to a portable JSON manifest:

Pass run input

Workflows that declare .accepts() take a JSON object on ecp run --input. The CLI validates that object against workflow.accepts before steps execute.
--dry-run runs the same input check without invoking capabilities. ecp validate still checks the graph and environment only. See Fluent API and Schemas.

Minimal Fluent workflow

Minimal Node environment

Operational APIs live on the instance returned by init():

Prefer the browser?

Open the hosted Graph Editor or follow Browser demo. For local Ollama, run ecp up so the demo can pair with a loopback bridge.

Next steps