Trackio documentation

Trackio

Hugging Face's logo
Join the Hugging Face 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 Hugging Face 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 Hugging Face Space (space_id) for free or to a self-hosted Trackio server (server_url)

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

  • Visualize experiments with a Gradio dashboard locally, on Hugging Face 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 Hugging Face, 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