Artifacts and models

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 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-rt 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-rt artifacts upload ./model.onnx --type model --version v2
uploading model.onnx (412 MB) ...
created artifact "model.onnx" (9c14...) version v2

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

artifacts external

clika-rt 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 id. Required for a private registry.
version	string	Version label, default v1.
description	string	Free text.
tags	object	Key and value metadata.

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

artifacts dataset

clika-rt 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-rt 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-rt 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-rt artifacts list --tag project:vision --exclude_tag status:archived

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

Downloading

clika-rt 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-rt artifacts download imagenet-val ./data/
clika-rt 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 artifact.
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-rt artifacts entries imagenet-val
clika-rt 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-rt dataset-builds create --body '<json>'
clika-rt 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-rt 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-rt models create --body '{"huggingface_url":"Qwen/Qwen2.5-0.5B-Instruct"}'
clika-rt models list --search qwen

Registering a model from a committed file works too:

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.

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 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-rt artifacts

artifacts has 26 subcommands.

clika-rt artifacts batch-delete

Batch delete artifacts

clika-rt 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-rt artifacts benchmarks

List benchmarks for an artifact

clika-rt 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-rt artifacts create

Upload artifact

clika-rt 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-rt artifacts dataset

Upload a dataset artifact

clika-rt 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-rt artifacts delete

Delete artifact

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

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

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

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

clika-rt 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-rt 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-rt artifacts entries

List a dataset artifact's entries

clika-rt 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-rt artifacts entry

Download a dataset artifact entry

clika-rt 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-rt artifacts expiry

Set or clear artifact expiry

clika-rt 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-rt artifacts external

Create external artifact

clika-rt 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-rt artifacts get

Get artifact

clika-rt 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-rt artifacts list

List artifacts

clika-rt 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-rt artifacts retention-policy

Get artifact retention policy

clika-rt 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-rt artifacts retention-policy-delete

Clear artifact retention policy

clika-rt 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-rt artifacts retention-policy-update

Set artifact retention policy

clika-rt 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-rt artifacts tags

List artifact tags

clika-rt 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-rt artifacts tags-delete-tag

Delete artifact tag

clika-rt 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-rt artifacts tags-update

Set artifact tag

clika-rt 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-rt artifacts update

Update artifact metadata

clika-rt 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-rt 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-rt 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-rt artifacts uploads-chunks

Upload one chunk of an artifact upload session

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

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

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/uploads/{id}/chunks/{index}. MCP tool name: put_artifacts_uploads_id_chunks_index.

clika-rt artifacts uploads-create

Create chunked artifact upload session

clika-rt 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-rt artifacts uploads-delete-id

Abort artifact upload session

clika-rt 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-rt artifacts uploads-id

Get artifact upload session status

clika-rt 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-rt artifacts versions

List artifact versions

clika-rt 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-rt artifacts versions-create

Create artifact version

clika-rt 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-rt models

models has 5 subcommands.

clika-rt models create

Register model

clika-rt 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-rt models get

Get model

clika-rt 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-rt models list

List models

clika-rt 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-rt models preview

Preview HuggingFace model metadata

clika-rt 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-rt models update

Update model task

clika-rt models 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: PATCH /api/models/{id}. MCP tool name: patch_models_id.

clika-rt dataset-builds

dataset-builds has 2 subcommands.

clika-rt dataset-builds create

Start a server-side dataset preprocessing build

clika-rt 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-rt dataset-builds get

Get a dataset build's status

clika-rt 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-rt registry-credentials

registry-credentials has 5 subcommands.

clika-rt registry-credentials create

Create registry credential

clika-rt 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-rt registry-credentials delete

Delete registry credential

clika-rt 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-rt registry-credentials get

Get registry credential

clika-rt 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-rt registry-credentials list

List registry credentials

clika-rt 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-rt registry-credentials update

Update registry credential

clika-rt 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.

Related

• Transfers: following a push of an artifact to a device.
• Devices: pushing an artifact to a device, and fetching files back.
• job definitions: declaring which artifacts a run needs.
• Benchmarks: models and datasets as benchmark inputs.
• Artifact concept: what an artifact is, external artifacts included, in prose.