---
title: Artifacts and models
sidebar_label: artifacts, models
description: "clika-cli artifacts and models: upload files the platform pushes to devices, register models from Hugging Face, and manage versions and retention."
---

An **artifact** is a file the platform stores for you: a model, a dataset, a script, a container image, a configuration file. Artifacts are what a [job definition](job-definitions.md) pushes to a device before it runs, and what a job leaves behind when it finishes.

A **model** is a thinner thing: a registration that points at a model on the Hugging Face Hub, carrying the task metadata the platform needs to decide which benchmarks apply to it. Registering a model does not copy its weights into your artifact library.

## Uploading

### `artifacts upload`

```
clika-cli artifacts upload <path> [flags]
```

Uploads one local file, or one local directory, to the artifact library. This command is hand-written rather than generated, because it streams, so a multi-gigabyte model never has to fit in memory.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--name` | string | the file name | Display name for the artifact. |
| `--type` | string | none | What kind of thing this is: `model`, `dataset`, `script`, `docker_image`, `config` or `other`. |
| `--version` | string | `v1` | Version label. Uploading the same name with a new label creates a new version in the same lineage. |
| `--description` | string | none | Free text. |

A **directory** is packed into a `tar.gz` first and registered with `content_format=directory`, so the platform pushes and unpacks it on a device as a single unit rather than as loose files.

A **large file** is uploaded in chunks and resumes on its own. A dropped connection, a proxy timeout or a platform redeploy costs you one chunk, not the whole transfer, and re-running an interrupted upload of the same file continues where it stopped. Content the platform already holds is reused without sending it a second time.

```
$ clika-cli artifacts upload ./model.onnx --type model --version v2
uploading model.onnx (412 MB) ...
created artifact "model.onnx" (9c14...) version v2
```

```
clika-cli artifacts upload ./dataset-dir --name imagenet-val --type dataset
clika-cli artifacts upload ./run.py --type script --version v3
```

### `artifacts external`

```
clika-cli artifacts external --body '<json>'
```

Registers something the platform pulls itself, rather than something you upload. The pull happens server side.

| Body field | Type | Meaning |
| --- | --- | --- |
| `name` | string, required | Display name. |
| `source_url` | string, required | Where to pull from. |
| `type` | string, required | `docker_image` or `git_repo`. |
| `credential_id` | string | A [registry credential](#registry-credentials) id. Required for a private registry. |
| `version` | string | Version label, default `v1`. |
| `description` | string | Free text. |
| `tags` | object | Key and value metadata. |

```
clika-cli artifacts external --body '{"name":"detector-model","source_url":"registry.example.com/detector:latest","type":"docker_image"}'
```

### `artifacts dataset`

```
clika-cli artifacts dataset --body '<json>'
```

Registers a dataset artifact with the structure the platform needs to enumerate its entries, which is what makes `artifacts entries` and `artifacts entry` work below.

## Finding artifacts

```
clika-cli artifacts list [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--type` | string | all | `model`, `dataset`, `script`, `docker_image`, `config` or `other`. |
| `--search` | string | none | Full-text search on the artifact name. |
| `--tag` | string, repeatable | none | Include only artifacts carrying this `key:value` tag. Repeating the flag narrows further. |
| `--exclude_tag` | string, repeatable | none | Exclude artifacts carrying this `key:value` tag. |
| `--latest_only` | string | `false` | Pass `true` to return only the newest version of each lineage. |
| `--min_size_bytes` | string | none | Only artifacts at least this large. |
| `--max_size_bytes` | string | none | Only artifacts at most this large. |
| `--created_after` | string | none | Only artifacts created at or after this RFC 3339 timestamp. |
| `--created_before` | string | none | Only artifacts created at or before it. |
| `--sort` | string | `created_at` | Sort column: `created_at`, `name`, `size_bytes`, `updated_at` or `type`. |
| `--dir` | string | `desc` | Sort direction, `asc` or `desc`. |
| `--page` | string | `1` | Page number. |
| `--page_size` | string | server default | Rows per page. |

```
$ clika-cli artifacts list --type model --latest_only true
NAME                     TYPE    VERSION   SIZE      CREATED
qwen2.5-0.5b.onnx        model   v2        412 MB    2d ago
detector.onnx            model   v1        12 MB     9d ago
```

```
clika-cli artifacts list --tag project:vision --exclude_tag status:archived
```

`artifacts get <name-or-id>` prints one artifact in full.

## Downloading

```
clika-cli artifacts download <name-or-id> <dest>
```

Streams the artifact's stored file to `<dest>`. When `<dest>` is an existing directory, the server-suggested filename is used inside it; anything else is taken as the file path to write.

```
clika-cli artifacts download imagenet-val ./data/
clika-cli artifacts download imagenet-val ./val.tar.gz
```

## Versions, tags and expiry

| Command | What it does |
| --- | --- |
| `artifacts versions <name-or-id>` | Every version in this artifact's lineage. |
| `artifacts versions-create <name-or-id> --body '<json>'` | Register a new version. |
| `artifacts update <name-or-id> --body '<json>'` | Change the metadata: name, description, type. |
| `artifacts tags <name-or-id>` | The artifact's tags. |
| `artifacts tags-update <name-or-id> --body '<json>'` | Set a tag. |
| `artifacts tags-delete-tag <name-or-id> <tag>` | Remove one tag. |
| `artifacts expiry <name-or-id> --body '<json>'` | Set or clear an expiry, after which the platform may reclaim the storage. |
| `artifacts retention-policy` | The deployment's retention policy, which is what an unset expiry falls back to. |
| `artifacts retention-policy-update --body '<json>'` | Set that policy. |
| `artifacts retention-policy-delete` | Clear it, restoring the default. |
| `artifacts delete <name-or-id>` | Delete one version, or every version of the artifact with `--all_versions`. |
| `artifacts batch-delete --body '<json>'` | Delete several at once. |
| `artifacts benchmarks <name-or-id>` | The benchmarks that used this artifact. |

## Dataset entries

A dataset artifact is browsable without downloading the whole thing:

```
clika-cli artifacts entries imagenet-val
clika-cli artifacts entry imagenet-val --body '<json>'
```

`entries` lists what is inside; `entry` downloads one item out of it.

### Server-side dataset builds

Preprocessing a dataset on the platform rather than on your laptop:

```
clika-cli dataset-builds create --body '<json>'
clika-cli dataset-builds get <id>
```

`create` starts a build and returns its id; `get` reports its status. The output is a new dataset artifact.

## Chunked upload sessions

`artifacts upload` manages resumable uploads for you, and these commands are the underlying session API, exposed for scripts that need to drive it directly:

| Command | What it does |
| --- | --- |
| `artifacts uploads-create --body '<json>'` | Open a chunked upload session. |
| `artifacts uploads-chunks <id> <index>` | Upload one chunk. |
| `artifacts uploads-id <id>` | Session status, including which byte ranges are still missing. |
| `artifacts uploads-delete-id <id>` | Abort the session. |

Prefer `artifacts upload` unless you have a specific reason not to.

## Models

```
clika-cli models [command]
```

| Subcommand | Purpose |
| --- | --- |
| `list` | Registered models. |
| `get <name-or-id>` | One model with its task and metadata. |
| `preview --body '<json>'` | Look up a Hugging Face model's metadata before registering it. |
| `create --body '<json>'` | Register a model. |
| `update <name-or-id> --body '<json>'` | Change the model's task. |

The create body takes `huggingface_url`, either a full URL or the `owner/repo` shorthand, and an optional `task`. Supply `task` only when the Hub has no pipeline tag of its own. It is recorded as a manual choice, and a real Hub tag is never overwritten by it. The task matters because it determines which benchmark types the model is compatible with.

```
clika-cli models create --body '{"huggingface_url":"Qwen/Qwen2.5-0.5B-Instruct"}'
clika-cli models list --search qwen
```

Registering a model from a committed file works too:

```yaml
kind: Model
huggingface_url: https://huggingface.co/Qwen/Qwen2.5-0.5B-Instruct
task: text-generation
```

## Registry credentials

Private container registries and Git remotes need a credential before the platform can pull from them.

| Command | What it does |
| --- | --- |
| `registry-credentials list` | Every credential, with its secret redacted. |
| `registry-credentials get <id>` | One credential. |
| `registry-credentials create --body '<json>'` | Store one. |
| `registry-credentials update <id> --body '<json>'` | Change one. |
| `registry-credentials delete <id>` | Delete one. |

Pass the resulting id as `credential_id` when you register an external artifact.

<!-- BEGIN GENERATED COMMAND REFERENCE (NOTES/gen-cli-reference.py) -->

## Full command reference

Every command below is generated from the deployment's own API description, so
one subcommand is exactly one platform operation. Each entry names the method,
the endpoint and the [MCP](mcp.md) tool name, so the same operation is
identifiable whichever surface you drive it from. Path parameters are positional
arguments, query parameters are flags, and a request body is `--body` or
`--body-file`. The hand-written commands, the ones that stream, propagate an
exit code, or hand your terminal to `ssh`, carry no operation line.

The prose above covers the commands most people reach for. This section is the
complete surface, for when you need the flag you have not used before.

### `clika-cli artifacts`

`artifacts` has 26 subcommands.

#### `clika-cli artifacts batch-delete`

Batch delete artifacts

```
clika-cli artifacts batch-delete [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--created_after` | string | none | Only artifacts created at or after this RFC 3339 timestamp |
| `--created_before` | string | none | Only artifacts created at or before this RFC 3339 timestamp |
| `--dry_run` | string | none | Preview only: report what would be deleted without deleting |
| `--exclude_tag` | string | none | Exclude artifacts whose tags contain the given 'key:value' (repeatable, ANDed NOT) |
| `--limit` | string | `100, max 500` | Maximum artifacts to act on in this call |
| `--max_size_bytes` | string | none | Only artifacts at most this many bytes |
| `--min_size_bytes` | string | none | Only artifacts at least this many bytes |
| `--raw` | bool | `false` | print raw response without pretty-printing |
| `--search` | string | none | Full-text search on artifact name |
| `--tag` | string | none | Include artifacts whose tags contain the given 'key:value' (repeatable, ANDed) |
| `--type` | string | none | Filter by type (model\|dataset\|script\|docker_image\|config\|other) |

Endpoint: `POST /api/artifacts/batch-delete`. MCP tool name: `post_artifacts_batch_delete`.

#### `clika-cli artifacts benchmarks`

List benchmarks for an artifact

```
clika-cli artifacts benchmarks <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/{id}/benchmarks`. MCP tool name: `get_artifacts_id_benchmarks`.

#### `clika-cli artifacts create`

Upload artifact

```
clika-cli artifacts create [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/artifacts`. MCP tool name: `post_artifacts`.

#### `clika-cli artifacts dataset`

Upload a dataset artifact

```
clika-cli artifacts dataset [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/artifacts/dataset`. MCP tool name: `post_artifacts_dataset`.

#### `clika-cli artifacts delete`

Delete artifact

```
clika-cli artifacts delete <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--all_versions` | string | `false` | Delete every version of the artifact, not only this one |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `DELETE /api/artifacts/{id}`. MCP tool name: `delete_artifacts_id`.

#### `clika-cli artifacts download`

Streams the artifact's stored file to `<dest>`. When `<dest>` is an existing directory the server-suggested filename is used inside it.

```
clika-cli artifacts download <name-or-id> <dest> [flags]
```

Positional arguments: required `<name-or-id>`, `<dest>`.

Endpoint: `GET /api/artifacts/{id}/download`. MCP tool name: `get_artifacts_id_download`.

#### `clika-cli artifacts entries`

List a dataset artifact's entries

```
clika-cli artifacts entries <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--page` | string | `1` | 1-based page number |
| `--per_page` | string | `100, max 1000` | Entries per page |
| `--prefix` | string | none | Only entries whose path starts with this prefix |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/{id}/entries`. MCP tool name: `get_artifacts_id_entries`.

#### `clika-cli artifacts entry`

Download a dataset artifact entry

```
clika-cli artifacts entry <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--path` | string | none | Entry path within the dataset (e.g. entries/clip-0.wav) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/{id}/entry`. MCP tool name: `get_artifacts_id_entry`.

#### `clika-cli artifacts expiry`

Set or clear artifact expiry

```
clika-cli artifacts expiry <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `PUT /api/artifacts/{id}/expiry`. MCP tool name: `put_artifacts_id_expiry`.

#### `clika-cli artifacts external`

Create external artifact

```
clika-cli artifacts external [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/artifacts/external`. MCP tool name: `post_artifacts_external`.

#### `clika-cli artifacts get`

Get artifact

```
clika-cli artifacts get <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/{id}`. MCP tool name: `get_artifacts_id`.

#### `clika-cli artifacts list`

List artifacts

```
clika-cli artifacts list [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--created_after` | string | none | Only artifacts created at or after this RFC 3339 timestamp |
| `--created_before` | string | none | Only artifacts created at or before this RFC 3339 timestamp |
| `--dir` | string | none | Sort direction: desc (default), asc |
| `--exclude_tag` | string | none | Exclude artifacts whose tags contain the given 'key:value' (repeatable, ANDed NOT) |
| `--latest_only` | string | none | Return only the latest version of each artifact lineage |
| `--max_size_bytes` | string | none | Only artifacts at most this many bytes |
| `--min_size_bytes` | string | none | Only artifacts at least this many bytes |
| `--page` | string | none | Page number (default: 1) |
| `--page_size` | string | none | Items per page |
| `--raw` | bool | `false` | print raw response without pretty-printing |
| `--search` | string | none | Full-text search on artifact name |
| `--sort` | string | none | Sort column: created_at (default), name, size_bytes, updated_at, type |
| `--tag` | string | none | Include artifacts whose tags contain the given 'key:value' (repeatable, ANDed) |
| `--type` | string | none | Filter by type (model\|dataset\|script\|docker_image\|config\|other) |

Endpoint: `GET /api/artifacts`. MCP tool name: `get_artifacts`.

#### `clika-cli artifacts retention-policy`

Get artifact retention policy

```
clika-cli artifacts retention-policy [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/retention-policy`. MCP tool name: `get_artifacts_retention_policy`.

#### `clika-cli artifacts retention-policy-delete`

Clear artifact retention policy

```
clika-cli artifacts retention-policy-delete [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `DELETE /api/artifacts/retention-policy`. MCP tool name: `delete_artifacts_retention_policy`.

#### `clika-cli artifacts retention-policy-update`

Set artifact retention policy

```
clika-cli artifacts retention-policy-update [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `PUT /api/artifacts/retention-policy`. MCP tool name: `put_artifacts_retention_policy`.

#### `clika-cli artifacts tags`

List artifact tags

```
clika-cli artifacts tags <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/{id}/tags`. MCP tool name: `get_artifacts_id_tags`.

#### `clika-cli artifacts tags-delete-tag`

Delete artifact tag

```
clika-cli artifacts tags-delete-tag <name-or-id> <tag> [flags]
```

Positional arguments: required `<name-or-id>`, `<tag>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `DELETE /api/artifacts/{id}/tags/{tag}`. MCP tool name: `delete_artifacts_id_tags_tag`.

#### `clika-cli artifacts tags-update`

Set artifact tag

```
clika-cli artifacts tags-update <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `PUT /api/artifacts/{id}/tags`. MCP tool name: `put_artifacts_id_tags`.

#### `clika-cli artifacts update`

Update artifact metadata

```
clika-cli artifacts update <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `PUT /api/artifacts/{id}`. MCP tool name: `put_artifacts_id`.

#### `clika-cli artifacts upload`

Uploads a local file to the artifact library. A directory is packed into a tar.gz first and registered with content_format=directory, so the platform pushes and unpacks it as a unit.

```
clika-cli artifacts upload <path> [flags]
```

Positional arguments: required `<path>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--description` | string | none | optional description |
| `--name` | string | none | artifact display name (defaults to the file name) |
| `--type` | string | none | artifact type: model, dataset, script, docker_image, config, other |
| `--version` | string | none | version label (server default: v1) |

#### `clika-cli artifacts uploads-chunks`

Upload one chunk of an artifact upload session

```
clika-cli artifacts uploads-chunks <id> <index> [flags]
```

Positional arguments: required `<id>`, `<index>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body-file` | string | none | request body (path to the raw file, sent as application/octet-stream) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `PUT /api/artifacts/uploads/{id}/chunks/{index}`. MCP tool name: `put_artifacts_uploads_id_chunks_index`.

#### `clika-cli artifacts uploads-create`

Create chunked artifact upload session

```
clika-cli artifacts uploads-create [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/artifacts/uploads`. MCP tool name: `post_artifacts_uploads`.

#### `clika-cli artifacts uploads-delete-id`

Abort artifact upload session

```
clika-cli artifacts uploads-delete-id <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `DELETE /api/artifacts/uploads/{id}`. MCP tool name: `delete_artifacts_uploads_id`.

#### `clika-cli artifacts uploads-id`

Get artifact upload session status

```
clika-cli artifacts uploads-id <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |
| `--seen` | string | none | The state the caller last observed; when the current state already differs, the request answers immediately instead of waiting. |
| `--wait_s` | string | none | Long-poll: hold the request open up to this many seconds until the state changes (from seen when supplied, else from its value at arrival) or turns terminal, then answer with the current status either way, the response shape is identical to an immediate read, so a plain poll loop keeps working unchanged. Clamped server-side (default maximum 55). Omit or 0 to answer immediately. Chunk arrivals do not end the wait; only a state transition does. |

Endpoint: `GET /api/artifacts/uploads/{id}`. MCP tool name: `get_artifacts_uploads_id`.

#### `clika-cli artifacts versions`

List artifact versions

```
clika-cli artifacts versions <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/artifacts/{id}/versions`. MCP tool name: `get_artifacts_id_versions`.

#### `clika-cli artifacts versions-create`

Create artifact version

```
clika-cli artifacts versions-create <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/artifacts/{id}/versions`. MCP tool name: `post_artifacts_id_versions`.

### `clika-cli models`

`models` has 6 subcommands.

#### `clika-cli models benchmark-groups`

List benchmark groups that include a model

```
clika-cli models benchmark-groups <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--page` | string | none | Page number (default: 1) |
| `--page_size` | string | `20, max 50` | Items per page |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/models/{id}/benchmark-groups`. MCP tool name: `get_models_id_benchmark_groups`.

#### `clika-cli models benchmarks`

List benchmarks run on a model

```
clika-cli models benchmarks <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--page` | string | none | Page number (default: 1) |
| `--page_size` | string | `25, max 200` | Items per page |
| `--raw` | bool | `false` | print raw response without pretty-printing |
| `--sort` | string | none | Row order: date (newest first, the default), latency (fastest first) or throughput (highest first) |

Endpoint: `GET /api/models/{id}/benchmarks`. MCP tool name: `get_models_id_benchmarks`.

#### `clika-cli models create`

Register model

```
clika-cli models create [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/models`. MCP tool name: `post_models`.

#### `clika-cli models get`

Get model

```
clika-cli models get <name-or-id> [flags]
```

Positional arguments: required `<name-or-id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/models/{id}`. MCP tool name: `get_models_id`.

#### `clika-cli models list`

List models

```
clika-cli models list [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--dir` | string | none | Sort direction: desc (default), asc |
| `--page` | string | none | Page number (default: 1) |
| `--page_size` | string | none | Items per page |
| `--raw` | bool | `false` | print raw response without pretty-printing |
| `--search` | string | none | Case-insensitive name substring filter |
| `--sort` | string | none | Sort column: created_at (default), name, updated_at |

Endpoint: `GET /api/models`. MCP tool name: `get_models`.

#### `clika-cli models preview`

Preview HuggingFace model metadata

```
clika-cli models preview [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/models/preview`. MCP tool name: `post_models_preview`.

### `clika-cli modelverse`

`modelverse` has 3 subcommands.

#### `clika-cli modelverse device-fit`

Which catalogue entries fit the caller's devices

```
clika-cli modelverse device-fit [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/modelverse/device-fit`. MCP tool name: `get_modelverse_device_fit`.

#### `clika-cli modelverse models`

List the Modelverse catalogue

```
clika-cli modelverse models [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--page` | string | none | Page number (default: 1) |
| `--page_size` | string | `25, at most 500` | Entries per page |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/modelverse/models`. MCP tool name: `get_modelverse_models`.

#### `clika-cli modelverse providers-logo`

Get a Modelverse provider's logo

```
clika-cli modelverse providers-logo <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |
| `--v` | string | none | Cache version; ignored by the server |

Endpoint: `GET /api/modelverse/providers/{id}/logo`. MCP tool name: `get_modelverse_providers_id_logo`.

### `clika-cli dataset-builds`

`dataset-builds` has 2 subcommands.

#### `clika-cli dataset-builds create`

Start a server-side dataset preprocessing build

```
clika-cli dataset-builds create [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/dataset-builds`. MCP tool name: `post_dataset_builds`.

#### `clika-cli dataset-builds get`

Get a dataset build's status

```
clika-cli dataset-builds get <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/dataset-builds/{id}`. MCP tool name: `get_dataset_builds_id`.

### `clika-cli registry-credentials`

`registry-credentials` has 5 subcommands.

#### `clika-cli registry-credentials create`

Create registry credential

```
clika-cli registry-credentials create [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `POST /api/registry-credentials`. MCP tool name: `post_registry_credentials`.

#### `clika-cli registry-credentials delete`

Delete registry credential

```
clika-cli registry-credentials delete <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `DELETE /api/registry-credentials/{id}`. MCP tool name: `delete_registry_credentials_id`.

#### `clika-cli registry-credentials get`

Get registry credential

```
clika-cli registry-credentials get <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/registry-credentials/{id}`. MCP tool name: `get_registry_credentials_id`.

#### `clika-cli registry-credentials list`

List registry credentials

```
clika-cli registry-credentials list [flags]
```

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `GET /api/registry-credentials`. MCP tool name: `get_registry_credentials`.

#### `clika-cli registry-credentials update`

Update registry credential

```
clika-cli registry-credentials update <id> [flags]
```

Positional arguments: required `<id>`.

| Flag | Type | Default | Meaning |
| --- | --- | --- | --- |
| `--body` | string | none | request body (inline JSON) |
| `--body-file` | string | none | request body (path to a JSON file) |
| `--raw` | bool | `false` | print raw response without pretty-printing |

Endpoint: `PUT /api/registry-credentials/{id}`. MCP tool name: `put_registry_credentials_id`.

<!-- END GENERATED COMMAND REFERENCE -->

## Related

- [Transfers](transfers.md): following a push of an artifact to a device.
- [Devices](devices.md): pushing an artifact to a device, and fetching files back.
- [job definitions](job-definitions.md): declaring which artifacts a run needs.
- [Benchmarks](benchmarks.md): models and datasets as benchmark inputs.
- [Artifact concept](../concepts/artifact.mdx): what an artifact is, external artifacts included, in prose.