Trackio Experiment Tracking

What it does

When your agent uses it

• Logging training metrics from a Python training script
• Setting up alerts for loss spikes or NaN gradients during training
• Checking training metrics or alerts from the command line

Example prompts

• “Add Trackio logging to this training loop and sync it to a private Space.”
• “Set up a Trackio alert that fires when validation loss spikes.”
• “List the metrics logged for the latest run with the trackio CLI.”

Requirements

• Python with the trackio package
• A Hugging Face account for Space syncing

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Set up training with alerts — insert trackio.alert() calls for diagnostic conditions
2. 2Launch training — run the script in the background
3. 3Poll for alerts — use trackio list alerts --project --json --since to check for new alerts
4. 4Read metrics — use trackio get metric ... to inspect specific values
5. 5Iterate — based on alerts and metrics, stop the run, adjust hyperparameters, and launch a new run

What it can do on your machine

Read from SKILL.md and the folder at commit ca0325b. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are python and bash).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Trackio Experiment Tracking loads about 1.3k tokens when it runs, and up to ~6.3k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 424 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~84

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from huggingface/skills at commit ca0325b, republished under its Apache-2.0 licence (© huggingface). 424 words, ~1,272 tokens.

name

huggingface-trackio

description

Track and visualize ML training experiments with Trackio. Use when logging metrics during training (Python API), firing alerts for training diagnostics, or retrieving/analyzing logged metrics (CLI). Supports real-time dashboard visualization, alerts with webhooks, HF Space syncing, and JSON output for automation.

import trackio

# Spaces are PUBLIC by default (good for shareable dashboards);
# pass private=True if the metrics should not be public
trackio.init(project="my-project", space_id="username/trackio", private=True)
trackio.log({"loss": 0.1, "accuracy": 0.9})
trackio.log({"loss": 0.09, "accuracy": 0.91})
trackio.finish()

trackio list projects --json
trackio get metric --project my-project --run my-run --metric loss --json

import trackio

trackio.init(project="my-project", config={"lr": 1e-4})

for step in range(num_steps):
    loss = train_step()
    trackio.log({"loss": loss, "step": step})

    if step > 100 and loss > 5.0:
        trackio.alert(
            title="Loss divergence",
            text=f"Loss {loss:.4f} still high after {step} steps",
            level=trackio.AlertLevel.ERROR,
        )
    if step > 0 and abs(loss) < 1e-8:
        trackio.alert(
            title="Vanishing loss",
            text="Loss near zero — possible gradient collapse",
            level=trackio.AlertLevel.WARN,
        )

trackio.finish()

trackio list alerts --project my-project --json --since "2025-01-01T00:00:00"

© huggingface, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/huggingface-trackio of huggingface/skills.

• SKILL.md
• references/alerts.md
• references/logging_metrics.md
• references/retrieving_metrics.md

Open the folder on GitHubat commit ca0325b

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in huggingface/skills, which our catalogue first saw on October 7, 2026.

• waybarrios/opencode-power-packskills/huggingface-trackio
• lingxling/awesome-skills-cnhuggingface-skills/skills/huggingface-trackio