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-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 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 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-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:

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-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
--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	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-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 5 subcommands.

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

Update model task

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

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.