# 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 buildv1alpha3
```

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

```bash
make deployv1alpha3
```

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

```bash
make undeployv1alpha3
```

## 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)