Getting Started

Get started with Katib

This guide describes how to get started with Katib and run a few examples.


You need to install the following Katib components to run examples:

Getting Started with Katib Python SDK

You can run your first hyperparameter tuning Katib Experiment using Python SDK.

In the following example we are going to maximize a simple objective function:

$$ F(a,b) = 4a - b^2 $$

The bigger \(a\) and the lesser \(b\) value, the bigger the function value \(F\).

If you install Katib standalone, make sure that you configure local kubeconfig to access your Kubernetes cluster where you installed Katib control plane.

If you install Katib as part of Kubeflow Platform, you can open a new Kubeflow Notebook to run this script.

Note. If you use Katib within Kubeflow Platform to run this example, you need to use this namespace: KatibClient(namespace="kubeflow-user-example-com").

# [1] Create an objective function.
def objective(parameters):
    # Import required packages.
    import time
    # Calculate objective function.
    result = 4 * int(parameters["a"]) - float(parameters["b"]) ** 2
    # Katib parses metrics in this format: <metric-name>=<metric-value>.

import kubeflow.katib as katib

# [2] Create hyperparameter search space.
parameters = {
    "a":, max=20),
    "b":, max=0.2)

# [3] Create Katib Experiment with 12 Trials and 2 CPUs per Trial.
katib_client = katib.KatibClient(namespace="kubeflow")

name = "tune-experiment"
    resources_per_trial={"cpu": "2"},

# [4] Wait until Katib Experiment is complete

# [5] Get the best hyperparameters.

You should get similar output for the most optimal Trial, hyperparameters, and observation metrics:

  "best_trial_name": "tune-experiment-nmggpxx2",
  "parameter_assignments": [
      "name": "a",
      "value": "19"
      "name": "b",
      "value": "0.13546396192975868"
  "observation": {
    "metrics": [
        "latest": "75.98164951501829",
        "max": "75.98164951501829",
        "min": "75.98164951501829",
        "name": "result"

In the Katib UI you should see list of all completed Trials with results:

Getting Started Example

Next steps


Was this page helpful?