Models

Model discovery, search, listing, and custom model-card management.

📄️ List known models

Return the effective model catalog: complete installed cards, the current signed registry snapshot, bundled fallback cards, and final operator-owned custom overrides. Entries expose active installed identity, current registry identity, update availability, verification state, and warn-only advisories.

📄️ List known models

OpenAI-style listing of Skulk's effective model catalog rather than only running instances. Entries distinguish the active installed generation from current signed registry truth and report updates, verification, advisories, and cluster model trust.

📄️ List cluster model-code approvals

Lists immutable model-card identities the operator has approved to execute repository Python across the cluster.

📄️ Approve model repository code for the cluster

Approves one exact signed-registry or content-derived custom-card identity for download and execution across the cluster. The elected master serializes the decision into replicated State; every node then persists its local runner-facing copy. Success is returned only after this API applies the indexed decision. The mutation requires direct loopback access or an authenticated operator-gateway credential.

📄️ Revoke cluster model repository-code approval

Revokes the operator's cluster-wide approval for one immutable model-card identity. Existing processes are not killed, but future downloads and runner starts fail closed. Success is returned only after this API applies the master-indexed decision. The mutation requires direct loopback access or an authenticated operator-gateway credential.

📄️ Fetch and add a custom model card

Add a custom model card to Skulk's model catalog so it becomes searchable and launchable. An optional gguf_file selects one exact quant from a multi-quant GGUF repository. Cards that can execute repository code remain blocked until the operator approves their exact identity in cluster Settings. The mutation requires direct loopback access or an authenticated operator-gateway credential.

📄️ Delete a custom model card

Remove a previously added custom model card from Skulk's local catalog.

📄️ Search Hugging Face for models

Search for models to add or launch. Pass mlx_only=true to restrict results to mlx-community; omit or pass false to search all of Hugging Face. Exact GGUF filename queries also inspect bounded candidate repository manifests and return the matched repo-relative file path.

📄️ Fetch a Hugging Face model card summary

Download a repository's model card README and return its first prose paragraphs with markup stripped, for the dashboard's model discovery popovers. The summary is empty when the card has no usable prose.

📄️ List a GGUF repository's quantizations

Enumerate the downloadable quantizations of a Hugging Face GGUF repository: one option per quant shard group with its loadable first shard, human label, exact total bytes, and shard count, smallest first. Companion artifacts such as speculative drafters and imatrix files are excluded.