---
title: "clika_runtime.modelverse.hub functions"
sidebar_label: "Functions"
description: "Module-level functions of clika_runtime.modelverse.hub."
---

<!-- Generated by tools/api_reference/generate_api_docs.py. Do not edit. -->

## `list_files`

```python
list_files(source: 'str', *, revision: 'str' = 'main', token: 'str | None' = None, offline: 'bool' = False) -> 'Any'
```

The file listing of a repository (or local directory) with byte
totals, without downloading anything.

## `list_models`

```python
list_models() -> 'list[_ext.ModelEntry]'
```

Every registered model family (ModelEntry objects: metadata, the
config and GGUF architecture names the family claims, what its runnable
factories serve (``served``), whether it is runnable, and what an
identity-only registration is).

## `normalize_source`

```python
normalize_source(source: 'str') -> 'tuple[str, str, str]'
```

Split a source into (repo, revision, weight selector): a hub URL or an
``org/model:tag`` spelling resolves to its parts; a plain source passes
through with empty revision and selector.

## `snapshot`

```python
snapshot(source: 'str', *, revision: 'str' = 'main', cache_dir: 'str | None' = None, token: 'str | None' = None, offline: 'bool' = False, weights: 'str | None' = None, include_weights: 'bool' = True, progress: 'Progress | None' = None, file_progress: 'FileProgress | None' = None) -> 'Any'
```

Resolve ``source`` (a hub repo id or a local directory) to a local
snapshot through the registry's download door, the one resolve
``clikart-cli fetch`` takes: the planning verdict first (a checkpoint the
runtime cannot serve refuses before any file moves), the download under
the families' own resolve options, the checkpoint's license line, then
the companions the family names (a codec checkpoint, say), each fetched
and named in the answer with its outcome. Returns what was resolved
(``local_dir``, ``files``, ``weights_primary`` on the GGUF lane,
``license_line`` or ``license_failure``, ``companions``).

``weights`` selects one option of a multi-option repo ("Q6_K", a glob,
a file name); a multi-option repo refuses without it, naming the options.
``include_weights=False`` fetches the small files only (the configuration,
the tokenizer and processor files) and answers with no license line and no
companions. ``progress(done, total)`` and ``file_progress(info)`` report
the download; return False from either to cancel. ``offline`` refuses any
network access and resolves strictly from the cache. A refusal raises the
runtime's typed error with the hub's own code name.

## `snapshot_download`

```python
snapshot_download(source: 'str', **options: 'Any') -> 'str'
```

Download (or find in the cache) the snapshot of ``source`` through the
registry's download door and return its local directory. Options are
those of :func:`snapshot`; the companions the family names are fetched
beside it, and the license line is logged.