Hyperparameter optimization
Hyperparameter optimization is the process of trying many parameter combinations and measuring which ones produce the best result. HyperOptimizer makes that search work for any Dockerized workload.
What HPO means here
A hyperparameter is an input you choose before a run starts. In a trading strategy, that might be a timeframe, stoploss, lookback window, or ATR multiplier. In a model training job, it might be learning rate, batch size, or regularization strength.
HyperOptimizer runs many trials, each with a different parameter set, and ranks them by the objective metric you choose.
Parameter
A value HyperOptimizer is allowed to change, such as --hpo-lookback-window.
Trial
One container execution with one concrete parameter set.
Objective
The metric that decides what "best" means, such as sharpe, loss, or profit_factor.
Why managed HPO
Local optimization works until the run takes too long, logs become hard to compare, or multiple researchers need the same experiment history. HyperOptimizer moves scheduling, parallelism, collection, and comparison into managed infrastructure while your code stays yours.
Local loops
- Runs on one machine unless you build orchestration.
- Metrics are often trapped in local logs or notebooks.
- Restarting, comparing, and sharing runs takes manual work.
Managed trials
- Runs trials as repeatable containers.
- Collects metrics from stdout into a dashboard.
- Lets the optimizer choose the next candidates from completed results.
The HyperOptimizer contract
The integration contract is intentionally small: build an image, parse CLI parameters, run one trial, print metrics.
Docker image
Your image contains everything the trial needs.
HPO args
HyperOptimizer appends --hpo-* arguments.
One run
Your program evaluates one parameter set and exits.
Metrics
You print hpo.metrics.* lines to stdout.
Continue with Trials or start building with the Quickstart.