Skip to content
parallel hyperparameter search
Python Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


phs is an ergonomic framework for performing hyperparameter searches on numerous cumpute instances of any arbitrary python function. This is achieved with minimal modifications inside your target function. Possible applications appear in expensive to evaluate numerical computations which strongly depend on hyperparameters such as machine learning.


  • capable of all kinds of parameter types such as continuous or discrete numerical values, categorical values and even arbitrary python statements
  • no binding to a particular python framework like TensorFlow or PyTorch
  • possible search strategies are explicit specification, random search and Bayesian Optimization
  • no limitation to the number of hyperparameter
  • parameter types and search strategies can be mixed for each parameter set
  • handy monitor and visualization functions for supervising the progress are already built-in
  • capability to continue the calculation in case of system/program failures without losing the results of already completed evaluations


The framework consists of the three main modules parameter_definition (see Preparation of the Target Function and Search Strategies), experiment_definition see (Experiment Definition) and compute_definition (see Compute Definition) which represents the semantic separation. This modularity enables the sole creation of search strategies or experiments without immediate start of the computation. In addition, the decoupled compute definition allows one computation to be stopped and to continue with a different worker pool for example to harness free nodes through upscaling over night.

Table of Contents

  1. Installation
  2. Quick Start
  3. Parallelization Technique
  4. Preparation of the Target Function
  5. Search Strategies
  6. Data Types, Order and Transfer of Parameters
  7. Experiment Definition
  8. Compute Definition
  9. Post Processing
  10. Examples


Peter Michael Habelitz
Fraunhofer-Institut für Techno- und Wirtschaftsmathematik ITWM
Fraunhofer-Platz 1, 67663 Kaiserslautern, Germany
Tel: +49 631 31600-4942, Fax: +49 631 31600-5942


PHS paper:

Habelitz, Peter Michael, and Janis Keuper. "PHS: A Toolbox for Parellel Hyperparameter Search." arXiv preprint arXiv:2002.11429 (2020).

You can’t perform that action at this time.