Skip to main content

Hyperparameter search

Explore independent configurations in parallel and select one with a reproducible objective.

Hyperparameter search

Activity responsibilities

ActivityResponsibility
prepare-datasetExecute the prepare dataset stage and publish its declared outputs for downstream activities.
trial-1Execute the trial 1 stage and publish its declared outputs for downstream activities.
trial-2Execute the trial 2 stage and publish its declared outputs for downstream activities.
trial-nExecute the trial N stage and publish its declared outputs for downstream activities.
compare-trialsExecute the compare trials stage and publish its declared outputs for downstream activities.
register-bestExecute the register best stage and publish its declared outputs for downstream activities.

Inputs

  • Dataset snapshot
  • Search space
  • Selection objective

Outputs

  • Trial models
  • Leaderboard
  • Selected model

Provenance to preserve

  • Parameters per trial
  • Failures and retries
  • Selection rationale

Source bundle

The executable workflow and its implementation files are maintained in the separate AkôFlow examples repository. The documentation intentionally keeps code, container recipes, generators, and validation scripts out of the narrative page.

Open the complete source bundle ↗

Verified local execution

These captures and the output manifest were produced by the fixture's local Docker run and validator. They are published with the same bundle as the runnable files.

Hyperparameter search workflow execution evidence
Workflow evidence
Hyperparameter search execution evidence
Execution evidence
Hyperparameter search output evidence
Output evidence

Execution considerations

Cap concurrent trials by accelerator capacity, budget, or queue policy. Reuse trial identities when resuming the workflow.

AkôFlow boundary: the engine schedules, deploys, executes, transfers data, and records evidence. The ML or agent framework remains an implementation choice inside each activity.