Hydra CLI tutorials
Learn the command-line path from an empty folder to a validated job, an observable run and an orchestrated workflow.
All lessons
Follow them in order, or jump to the one you need.
Explore the hdrctl command surface
Read the global options, discover every command, and open focused help for the next action.
hdrctl --help Scaffold your first job
Create the project and read the files the template just produced.
hdrctl init Check the manifests before touching data
Separate a declaration error from an execution error, before anything is written.
hdrctl validate Prove the connection exists
Confirm source and destination access without producing a single row.
hdrctl test Run the job and read the evidence
Execute, read the counters and locate the file the run produced.
hdrctl run Turn up the verbosity when something is unclear
Move from a one-line summary to a step-by-step log of the same run.
hdrctl run -vv Change one value without touching the YAML
Replay the same job on another scope by overriding a parameter at run time.
hdrctl run -P Ask the project what it contains
Inventory the declared sources and destinations without opening a file.
hdrctl list Compose your jobs into a workflow
Declare dependencies between jobs and validate the whole before running it.
hdrctl workflow Run the workflow and follow every state
Read one terminal state per step, then replay only what needs replaying.
hdrctl workflow run Serve Hydra for Studio and the API
Start the backend on a workspace so Studio and the API share the same project.
hdrctl serve