---
title: "Creating a Model"
description: "Create a new AI model in Koios"
source_url: https://ai-ops.com/docs/models/creating-a-model
---

# Creating a Model

Models are created from the **Models** list page. You provide a name and optionally upload a model file in the same step.

## Create Model Dialog

Click **Add Model** in the top-right corner to open the create dialog.

| Field | Required | Description |
|-------|----------|-------------|
| **Name** | Yes | A unique name for the model |
| **Description** | No | Optional notes about the model's purpose |
| **Model File** | No | An ONNX (`.onnx`) or TFLite (`.tflite`) file to upload immediately |

If you select a model file, two additional fields appear:

| Field | Required | Description |
|-------|----------|-------------|
| **Version** | No | A version label (e.g. `1.0.0` or `v2-beta`). If left blank, an auto-generated name like `warm-fox-12` is assigned. |
| **Notes** | No | Optional notes about this file version |

The button label changes to **Create & Upload** when a file is attached.

## What Gets Set Automatically

The create dialog only asks for the essentials. All other settings start with sensible defaults and can be changed on the **Configuration** tab after creation:

| Setting | Default |
|---------|---------|
| Output Application | Absolute |
| Output Mode | Continuous |
| Scan Rate | 1s |
| Sample Rate | 1s |
| Enabled | Off |

## After Creation

Where you land depends on whether you included a file:

- **Without a file** — you're taken to the model's **Files** tab so you can upload one
- **With a file** — the file is uploaded and activated automatically, then you're taken to the **Configuration** tab

If the model was created but the file upload fails (network issue, invalid file), an alert explains that the model exists and you can upload later from the Files tab.

> [!NOTE] Embedded metadata
> If your ONNX file contains embedded Koios metadata (`koios.training` and `koios.bindings` properties), those values are automatically applied to the model's configuration and bindings on the first upload. See [Embedded Metadata](https://ai-ops.com/docs/models/model-files.md#embedded-metadata) for details.

## Next Steps

After creation, a model needs three things before it can run:

1. **An active model file** — uploaded during creation or added on the [Files](https://ai-ops.com/docs/models/model-files.md#uploading-a-file) tab
2. **Bindings assigned to tags** — see [Assigning Bindings](https://ai-ops.com/docs/models/assigning-bindings.md)
3. **Enable the model** — toggle Enabled in the model header or Configuration tab

## Duplicating a Model

To create a copy of an existing model, open the model's detail page, click the **three-dot menu** in the header, and select **Duplicate**. Enter a new name and the model is cloned with all its configuration. You'll be taken to the new model's Configuration tab.

> [!TIP] Review output tag assignments
> Duplicating a model copies configuration settings and model files. Input tag assignments are copied, but output tag assignments are cleared — you'll need to assign output tags on the new model's Bindings tab.