YOLOv8-16bit/docs/cli.md

If you want to train, validate or run inference on models and don't need to make any modifications to the code, using
YOLO command line interface is the easiest way to get started.

!!! tip "Syntax"

    ```bash
    yolo task=detect    mode=train    model=yolov8n.yaml      args...
              classify       predict        yolov8n-cls.yaml  args...
              segment        val            yolov8n-seg.yaml  args...
                             export         yolov8n.pt        format=onnx  args...
    ```

The default arguments can be overridden directly by passing custom `arg=val` covered in the next section. You can run
any supported task by setting `task` and `mode` in CLI.
=== "Training"

    |                  | `task`     | snippet                                                    |
    |------------------|------------|------------------------------------------------------------|
    | Detection        | `detect`   | <pre><code>yolo detect train       </code></pre> |
    | Instance Segment | `segment`  | <pre><code>yolo segment train      </code></pre> |
    | Classification   | `classify` | <pre><code>yolo classify train    </code></pre>  |

=== "Prediction"

    |                  | `task`     | snippet                                                      |
    |------------------|------------|--------------------------------------------------------------|
    | Detection        | `detect`   | <pre><code>yolo detect predict       </code></pre> |
    | Instance Segment | `segment`  | <pre><code>yolo segment predict     </code></pre>  |
    | Classification   | `classify` | <pre><code>yolo classify predict    </code></pre>  |

=== "Validation"

    |                  | `task`     | snippet                                                   |
    |------------------|------------|-----------------------------------------------------------|
    | Detection        | `detect`   | <pre><code>yolo detect val        </code></pre> |
    | Instance Segment | `segment`  | <pre><code>yolo segment val       </code></pre> |
    | Classification   | `classify` | <pre><code>yolo classify val      </code></pre> |

!!! note ""

    <b>Note:</b> The arguments don't require `'--'` prefix. These are reserved for special commands covered later

---

## Overriding default config arguments

Default arguments can be overriden by simply passing them as arguments in the CLI.

!!! tip ""

    === "Syntax"
        ```bash
        yolo task mode arg=val...
        ```

    === "Example"
        Perform detection training for `10 epochs` with `learning_rate` of `0.01`
        ```bash
        yolo detect train epochs=10 lr0=0.01
        ```

---

## Overriding default config file

You can override config file entirely by passing a new file. You can create a copy of default config file in your
current working dir as follows:

```bash
yolo copy-config
```

You can then use `cfg=default_copy.yaml` command to pass the new config file along with any addition args:

```bash
yolo cfg=default_copy.yaml args...
```

??? example

    === "Command"
        ```bash
        yolo copy-config
        yolo cfg=default_copy.yaml args...
        ```