Container requirements
HyperOptimizer can run any container that follows the trial contract. Keep images repeatable, observable, and safe to run in parallel.
Required
- The image can be pulled by HyperOptimizer.
- The default command or configured command starts the trial.
- The command accepts appended
--hpo-*arguments. - The process exits when the trial is done.
- Successful trials print at least one valid metric line.
Recommended
Pin dependencies
Reproducibility matters when comparing trials over time.
Log clearly
Print enough context to diagnose bad data, bad arguments, and runtime failures.
Avoid shared writes
Parallel containers should not overwrite the same external path.
Runtime behavior
The container should treat each trial as isolated. If a parameter set is invalid, either exit with a clear error or emit a penalty metric that your objective can rank appropriately.
hpo.metrics.objective=-9999
hpo.metrics.invalid_reason="lookback window larger than dataset"