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 是一个轻量级、免费的实验跟踪 Python 库,构建于 Hugging Face Buckets 和 Spaces 之上 🤗。

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

  • 与 wandb.init、wandb.log 和 wandb.finish API 兼容。可直接替换:只需

    import trackio as wandb
  • 本地优先设计:仪表板默认在本地运行。您也可以免费记录到 Hugging Face Space(space_id),或记录到自托管的 Trackio 服务器(server_url)

  • 在本地持久化日志,在使用 Spaces 时持久化到 Hugging Face Bucket,或在托管自托管服务器的机器上持久化。(通过 dataset_id / TRACKIO_DATASET_ID 持久化到 Hugging Face Dataset 已弃用,并将在未来版本中移除;请改用通过 bucket_id / TRACKIO_BUCKET_ID 持久化到 Bucket。)

  • 在本地、Hugging Face Spaces 或自托管时在自己的主机上,使用 Gradio 仪表盘可视化实验

  • 对 LLM 友好:专为自主 ML 实验设计,提供 CLI 命令和 Python API,使 LLM 能够轻松记录和查询实验数据。

  • 这里的一切,包括在 Hugging Face 上的托管,都是免费的!

Trackio 旨在保持轻量级(核心代码库的 Python 代码不到 3,000 行),而非功能全面。它采用可扩展的方式设计,并完全使用 Python 编写,以便开发人员可以轻松 fork 该仓库并添加他们关注的功能。

Update on GitHub