Skip to content

Commit b123aae

Browse files
committed
changes
1 parent 3eddf51 commit b123aae

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

trackio.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Most machine learning researchers use specific experiment tracking libraries to
1717

1818
## Why We Switched to Trackio
1919

20-
At Hugging Face, our science team has been using Trackio for our research projects, and we've found several key advantages over other tracking solutions:
20+
At Hugging Face, our science team has started using [Trackio](https://github.com/gradio-app/trackio) for our research projects, and we've found several key advantages over other tracking solutions:
2121

2222
**Easy Sharing and Embedding**: Trackio makes it incredibly simple to share training progress with colleagues or embed plots directly in blog posts and documentation using iframes. This is especially valuable when you want to showcase specific training curves or metrics without requiring others to set up accounts or navigate complex dashboards.
2323

@@ -27,7 +27,7 @@ At Hugging Face, our science team has been using Trackio for our research projec
2727

2828
**Flexibility for Experimentation**: Trackio's lightweight design allows us to easily experiment with new tracking features during training runs. For instance, we can decide when to move tensors from GPU to CPU when logging tensors while training, which significantly improves training throughput when you need to track model/intermediate states without impacting performance.
2929

30-
That's why the Hugging Face open-source team is excited to introduce: `trackio`, a completely free, open-source Python library...
30+
So what is `trackio`? It's an [open-source Python library](https://github.com/gradio-app/trackio) that lets you track any metrics and visualize them using a local [Gradio](https://gradio.dev/) dashboard. You can also sync this dashboard to Hugging Face Spaces, which means you can then share the dashboard with other users simply by sharing a URL. Since Spaces can be private or public, this means you can share a dashboard publicly or just within members of your Hugging Face organization.
3131

3232
## Installing
3333

@@ -114,20 +114,27 @@ Or in Python:
114114
trackio.show(project="my project")
115115
```
116116

117-
To deploy the dashboard to Hugging Face Spaces, pass a `space_id` to `init`:
117+
### Sharing with 🤗 Spaces
118+
119+
To sync your local dashboard to Hugging Face Spaces, simply pass a `space_id` to `init`:
118120

119121
```python
120122
trackio.init(project="fake-training", space_id="org_name/space_name")
121123
```
122124

123-
If you are hosting your dashboard on Spaces, you can embed it anywhere using an iframe:
125+
If you are hosting your dashboard on Spaces, you can simply share the URL or embed it anywhere using an iframe:
124126

125127
```html
126128
<iframe src="https://org_name-space_name.hf.space/?project=fake-training&metrics=train_loss,train_accuracy&sidebar=hidden" width=600 height=600 frameBorder="0"></iframe>
127129
```
128130

129131
<iframe src="https://trackio-documentation.hf.space/?project=fake-training&metrics=train_loss,train_accuracy&sidebar=hidden" width=600 height=600 frameBorder="0"></iframe>
130132

133+
134+
Since Spaces can be private or public, this means you can share a dashboard publicly or just within members of your Hugging Face organization — all for free!
135+
136+
When you sync your Trackio dashboard to Hugging Face Spaces, the data is logged to an ephemeral Sqlite database on Spaces. Because this database is reset if your Space restarts, Trackio also converts the Sqlite database to a Parquet dataset and backs it up to a Hugging Face Dataset every 5 minutes. This means you can visualize your
137+
131138
### Integrated with 🤗 Transformers and 🤗 Accelerate
132139

133140
Trackio integrates natively with Hugging Face libraries like `transformers` and `accelerate`, so you can log metrics with minimal setup.

0 commit comments

Comments
 (0)