Overview
A DAG workflow engine that orchestrates code in Docker containers via light-run.
light-process is a lightweight DAG workflow engine. You describe a graph of nodes (each a Docker container with an optional input/output schema) connected by links (which carry data and gate routing with conditions). light-process runs the graph, fanning out independent nodes, following or skipping links by their conditions, looping on bounded back-links, and validating every payload.
Execution itself is delegated: each node runs on a light-run instance over HTTP, which in turn drives light-runner and Docker. light-process never touches Docker directly; it owns orchestration, identity, and structured results.
Where to start
- Getting started - install, point at a light-run instance, run the example.
- Workflows - the model: nodes, links, the
workflow.jsonshape, networks and services. - Conditions - the
whenoperators that gate links. - Schema validation - input/output JSON Schema on nodes.
- SDK guide - building and running workflows from code.
- CLI reference - the
lightcommand. - Execution - how nodes map onto light-run.
- API reference - generated from the TypeScript types.
The ecosystem
| Project | Role |
|---|---|
| light-runner | Docker execution SDK. The primitive. |
| light-run | HTTP server around light-runner. |
| light-process | This DAG workflow engine. Calls light-run over HTTP. |