Table of Contents
=================

   * [Table of Contents](#table-of-contents)
   * [Developer Guide](#developer-guide)
      * [Requirements](#requirements)
      * [Build from source code](#build-from-source-code)
      * [Workflow design](#workflow-design)
      * [Implement a new algorithm and use it in Katib](#implement-a-new-algorithm-and-use-it-in-katib)
      * [Create a new Trial kind](#create-a-new-trial-kind)
      * [Algorithm settings documentation](#algorithm-settings-documentation)
      * [Design proposals](#design-proposals)

Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)

# Developer Guide

This developer guide is for people who want to contribute to the Katib project. 
If you're interesting in using Katib in your machine learning project, 
see the following user guides:

* [Concepts](https://www.kubeflow.org/docs/components/hyperparameter-tuning/overview/) 
  in Katib, hyperparameter tuning, and neural architecture search.
* [Getting started with Katib](https://kubeflow.org/docs/components/hyperparameter-tuning/hyperparameter/).
* Detailed guide to [configuring and running a Katib 
  experiment](https://kubeflow.org/docs/components/hyperparameter-tuning/experiment/).

## Requirements

- [Go](https://golang.org/)
- [Dep](https://golang.github.io/dep/)
- [Docker](https://docs.docker.com/) (17.05 or later.)

## Build from source code

Check source code as follows:

```bash
make build
```

You can deploy Katib v1alpha3 manifests into a k8s cluster as follows:

```bash
make deploy
```

You can undeploy Katib v1alpha3 manifests from a k8s cluster as follows:

```bash
make undeploy
```

## Workflow design

Please see [workflow-design.md](./workflow-design.md)

## Implement a new algorithm and use it in Katib

Please see [new-algorithm-service.md](./new-algorithm-service.md)

## Create a new Trial kind

Please see [new-trial-kind.md](./new-trial-kind.md)

## Algorithm settings documentation

Please see [algorithm-settings.md](./algorithm-settings.md)

## Katib UI documentation

Please see [Katib UI README](https://github.com/kubeflow/katib/tree/master/pkg/ui/v1alpha3)

## Design proposals

Please see [proposals](./proposals)