Your first workflow

1. Create the workflow file

Create a file called hello.duck.yaml with the following content:

flow:
  - type: exec
    run: echo "Hello, duckflux!"

That’s it — one step, one command. A workflow is just a YAML file with a flow field.

---

2. Install the runtime

Duckflux workflows are plain YAML files — they need a runtime to execute. Run the install script to auto-detect your package manager:

curl -fsSL https://duckflux.github.io/apt-repo/install.sh | bash

Note

The script detects apt, brew, bun, or npm automatically. For manual options, see the full CLI installation guide.

---

3. Run the workflow

Once the runtime is installed, run your workflow:

quack run hello.duck.yaml

The runtime reads the file, executes the flow, and prints the output:

Hello, duckflux!

---

Tip

Workflows support much more — parallel execution, loops, conditionals, error handling, retry, timeouts, and nested sub-workflows. See Workflow files for the full reference.