Model Catalog - Xerotier

Browsing the Catalog

The model catalog at /models/catalog displays all publicly shared models. It is accessible without authentication, though deploying a model requires a logged-in account.

Models are organized by architecture family (e.g., Llama, Qwen, Mistral, MoE). Each family has a visual grouping with its logo and description. Within each family, models are displayed as cards showing key information.

Model Card Information

Name -- Model display name.
Description -- Brief description of the model's capabilities.
Parameter count -- Number of parameters (e.g., 7B, 70B).
Context length -- Maximum context window in tokens.
License -- Model license (e.g., Apache 2.0, Llama 3).
Architecture -- Model architecture family.
Tags -- Workload type tags (chat, code, reasoning, etc.).
Badges -- Special indicators for notable models.

Filtering & Tags

Filter models by workload type using tags:

Tag	Description
`chat`	General-purpose conversational models.
`code`	Code generation and completion.
`reasoning`	Chain-of-thought and analytical reasoning.
`embedding`	Text embedding for semantic search.
`multilingual`	Strong multilingual support.

Badges

Badge	Criteria
Shared	Model is loaded on shared infrastructure and available on shared tiers.
XIM Only	Model is in the catalog but requires a XIM node to deploy.
Popular	Models with 10 or more deployments across the platform.
Featured	Models highlighted by platform administrators.

Model Details

Click on a model card to view its detail page at /models/catalog/:id. The detail page includes:

Full model description rendered from markdown.
Complete metadata: architecture, parameter count, context length, quantization, license.
Deployment button for logged-in users to add the model to their project.

To deploy a catalog model, click the deploy button on the detail page. This creates an endpoint in your project using the shared model. You must be logged in and have an active project.

Shared Model Availability

Shared models are subject to change. Models available on shared agents may be evicted or replaced at any time. Endpoints using shared models on shared tiers may become unavailable if the backing model is removed from shared infrastructure. For guaranteed availability and permanence, deploy models on XIM nodes.

Catalog models have one of two roles:

Shared -- The model is currently loaded on shared infrastructure and can be used with any tier, including shared tiers. This status is set automatically by the platform when a shared agent loads the model.
XIM Only (Deployable) -- The model is visible in the catalog but requires a XIM node to deploy. It is not currently loaded on any shared infrastructure.

A model's role can change over time. A "Shared" model may revert to "XIM Only" if it is evicted from shared agents. Plan accordingly and consider XIM deployments for production workloads that require stable model availability.

Publishing to the Catalog

To make your model visible in the public catalog, use the share command:

Shell

                    # Share a model to the catalog
xeroctl models share <model-id>

# Remove from the catalog
xeroctl models unshare <model-id>
                

Or use the API directly:

curl

                    # Share
curl -X POST https://api.xerotier.ai/proj_ABC123/v1/models/MODEL_ID/share \
  -H "Authorization: Bearer xero_myproject_your_api_key"

# Unshare
curl -X POST https://api.xerotier.ai/proj_ABC123/v1/models/MODEL_ID/unshare \
  -H "Authorization: Bearer xero_myproject_your_api_key"
                

Python

                    import requests

headers = {"Authorization": "Bearer xero_myproject_your_api_key"}
base = "https://api.xerotier.ai/proj_ABC123/v1"
model_id = "MODEL_ID"

# Share a model
response = requests.post(
    f"{base}/models/{model_id}/share",
    headers=headers
)
print(f"Shared: {response.json()}")

# Unshare a model
response = requests.post(
    f"{base}/models/{model_id}/unshare",
    headers=headers
)
print(f"Unshared: {response.json()}")
                

Node.js

                    const headers = {
    "Authorization": "Bearer xero_myproject_your_api_key"
};
const base = "https://api.xerotier.ai/proj_ABC123/v1";
const modelId = "MODEL_ID";

// Share a model
const shareResponse = await fetch(
    `${base}/models/${modelId}/share`,
    { method: "POST", headers }
);
console.log("Shared:", await shareResponse.json());

// Unshare a model
const unshareResponse = await fetch(
    `${base}/models/${modelId}/unshare`,
    { method: "POST", headers }
);
console.log("Unshared:", await unshareResponse.json());
                

What Becomes Public

When you share a model, the following information becomes publicly visible:

Model name, description, and version
Architecture, parameter count, context length, and license
Quantization details and format
Workload type tags
Deployment count

Your project name and identity are associated with the catalog entry. Unsharing a model removes it from the catalog but does not affect existing deployments by other users.