Trackio documentation

Trackio

HF Mirror's logo
Join the HF Mirror community

and get access to the augmented documentation experience

to get started

Trackio

trackio is a lightweight, free experiment tracking Python library built on top of HF Mirror Datasets and Spaces 🤗.

Screen Recording 2025-07-28 at 5 26 32 PM

  • API compatible with wandb.init, wandb.log, and wandb.finish. Drop-in replacement: just

    import trackio as wandb
  • Local-first design: dashboard runs locally by default. You can also log to a HF Mirror Space (space_id) for free or to a self-hosted Trackio server (server_url)

  • Persists logs locally, in a HF Mirror Dataset when using Spaces, or on the machine hosting your self-hosted server

  • Visualize experiments with a Gradio dashboard locally, on HF Mirror Spaces, or on your own host when self-hosting

  • LLM-friendly: Designed for autonomous ML experiments with CLI commands and Python APIs that enable LLMs to easily log and query experiment data.

  • Everything here, including hosting on HF Mirror, is free!

Trackio is designed to be lightweight (the core codebase is <3,000 lines of Python code), not fully-featured. It is designed in an extensible way and written entirely in Python so that developers can easily fork the repository and add functionality that they care about.

Update on GitHub