Your first workflow

This tutorial creates a workflow project, pushes it to EigenPal, runs it on a file, and reads the output.

1. Install the CLI

npm install -g @eigenpal/cli
eigenpal auth login

auth login opens a browser to create an API key and stores it locally. One key maps to one tenant.

2. Scaffold a project

eigenpal init workflow parse-invoice
cd parse-invoice

You get a self-contained project: workflow.yaml, evaluators.yaml, and a dataset/ folder. Open workflow.yaml to see the step graph.

3. Validate and push

eigenpal workflow validate     # check the project locally
eigenpal workflow push         # create the workflow (or a new version)

push prints the workflow id (wf_...). Validation runs locally first, so you catch schema mistakes before anything hits the server.

4. Run it on a file

eigenpal run workflows.parse-invoice --input-file document=invoice.pdf

File fields use --input-file name=path. The command starts a run and prints a run id (exec_...).

5. Read the output

eigenpal runs get <run-id>        # status + output JSON
eigenpal runs watch <run-id>      # live, until it finishes
eigenpal runs trace <run-id>      # per-step detail

runs get prints the structured output. runs trace shows what each step did, which is where you look when a step produced the wrong thing.

Add examples and ground truth in Build a dataset.
Score the workflow in Evaluate a workflow.
Browse every step type under Workflow steps.

Get started

Concepts

Workflow steps

Guides & tutorials

Changelog

1. Install the CLI

2. Scaffold a project

3. Validate and push

4. Run it on a file

5. Read the output

Next

​1. Install the CLI

​2. Scaffold a project

​3. Validate and push

​4. Run it on a file

​5. Read the output

​Next

1. Install the CLI

2. Scaffold a project

3. Validate and push

4. Run it on a file

5. Read the output

Next