What is Trackio?
Trackio is a free experiment tracking library from Hugging Face for logging metrics, media, and tables from machine learning runs. It is local-first: the dashboard runs on your machine by default and logs are stored in a SQLite database, so you don't need to create an account to start tracking. It sits in the Experiment Tracking category of the Training & Fine-Tuning tools and is open-source, written in Python.
Overview
Trackio is a free experiment tracking library from Hugging Face for logging metrics, media, and tables from machine learning runs. It is local-first: the dashboard runs on your machine by default and logs are stored in a SQLite database, so you don't need to create an account to start tracking.
Its API mirrors wandb. You can write `import trackio as wandb` and keep your existing `init`, `log`, and `finish` calls, which makes it a drop-in replacement for teams already using that logging style. A Gradio-inspired dashboard ships with it for viewing metrics and media.
As an experiment-tracking tool, Trackio fits both human and agent-driven workflows. Because runs live in SQLite, it includes a CLI for querying data (including read-only SQL), which is handy for LLM-driven analysis and high-throughput parallel experiments. You can optionally push runs to a free Hugging Face Space for collaboration.
What it does
- API-compatible with wandb.init, wandb.log, and wandb.finish, so existing logging code works with `import trackio as wandb`
- Local-first by default: runs are stored in a SQLite database on your machine, no account required
- Built-in Gradio-inspired dashboard to view metrics, media, tables, and alerts
- CLI for programmatic access, including read-only SQL queries over your run data
- Cloud-optional: pass a space_id to log to a free Hugging Face Space for collaborative experiments
- Forkable design — Python backend and API with a Svelte 5 dashboard you can extend or replace
Getting started
Trackio requires Python 3.10 or higher. Install it, log some metrics, then open the dashboard.
Install Trackio
Install from PyPI with pip (or uv).
pip install trackioLog metrics from your training loop
Initialize a project, log metrics each step, and finish the run. The API matches wandb, so you can also write `import trackio as wandb`.
import trackio
trackio.init(
project="my-project",
config={"epochs": 8, "learning_rate": 0.001, "batch_size": 64}
)
trackio.log({
"train_loss": 0.42,
"train_accuracy": 0.88,
})
trackio.finish()Launch the dashboard
View your runs locally in the browser. Pass a project name to open it directly.
trackio show --project "my-project"Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Track loss and accuracy across local training runs without signing up for a hosted service
- Migrate off wandb with minimal code changes by aliasing trackio as wandb
- Let LLMs or agents analyze experiment results by running read-only SQL queries over the SQLite store
- Push local runs to a free Hugging Face Space to share results with collaborators
How Trackio compares
Trackio alongside other open-source experiment tracking tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| MLflow | ★ 28.9k | An open-source ML and GenAI platform that, alongside experiment tracking, provides evaluation and monitoring tools for scoring and comparing LLM and agent outputs. |
| DVC | ★ 16k | A Git-like version control tool for datasets, models, and experiments that makes ML projects reproducible. |
| Weights & Biases (wandb) | ★ 11.3k | An open-source client library for logging experiments, running hyperparameter sweeps, and versioning models and datasets. |
| ClearML | ★ 6.9k | An open-source MLOps suite whose experiment manager auto-logs runs, metrics, and artifacts and ties them into data management and orchestration. |
| Aim | ★ 6.3k | A self-hosted, open-source experiment tracker that logs and compares thousands of training runs through a fast web UI. |
| Sacred | ★ 4.4k | A Python tool for configuring, organizing, logging, and reproducing computational research experiments. |
| Polyaxon | ★ 3.7k | An open-source platform for tracking, scheduling, and managing large-scale deep learning experiments on Kubernetes. |
| Trackio | ★ 1.8k | Local-first experiment tracking that drops in for wandb |

