docs: add TRL integration guide by abidlabs · Pull Request #537 · gradio-app/trackio

abidlabs · 2026-04-27T16:03:08Z

Add a TRL integration page (docs/source/trl_integration.md) mirroring the Transformers guide, with a runnable SFTTrainer snippet and project/space configuration example.
Add examples/trl-integration.py, a complete end-to-end SFT example using a tiny test model that runs in well under a minute. Verified locally.
Rename the Integration section sidebar titles to "Running with Transformers", "Running with TRL", and "Running with RapidFire AI" so the docs are easier to find from the table of contents (per Aksel's suggestion).

For ML-Intern -- see internal context: https://huggingface.slack.com/archives/C08SW1X12C8/p1777305610753559?thread_ts=1777063926.876859&cid=C08SW1X12C8

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

gradio-pr-bot · 2026-04-27T16:03:43Z

🪼 branch checks and previews

•	Name	Status	URL
🦄	Changes	detected!	Details

gradio-pr-bot · 2026-04-27T16:03:44Z

🦄 no changes detected

This Pull Request does not include changes to any packages.

__No changes detected. __

‼️ Changeset not approved. Ensure the version bump is appropriate for all packages before approving.

Maintainers can approve the changeset by checking this checkbox.

Something isn't right?

Maintainers can change the version label to modify the version bump.
If the bot has failed to detect any changes, or if this pull request needs to update multiple packages to different versions or requires a more comprehensive changelog entry, maintainers can create the changelog file directly.

HuggingFaceDocBuilderDev · 2026-04-27T16:04:34Z

🪼 branch checks and previews

•	Name	Status	URL
	Spaces	ready!	Spaces preview

Install Trackio from this PR (includes built frontend)

pip install "https://huggingface.co/buckets/trackio/trackio-wheels/resolve/adaeee3b8988f7ee72e419f9d478ceee1a591689/trackio-0.25.1-py3-none-any.whl"

HuggingFaceDocBuilderDev · 2026-04-27T16:05:00Z

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

Copilot

Pull request overview

This PR adds documentation and a runnable example demonstrating Trackio’s native integration with Hugging Face TRL trainers, and updates the docs sidebar labels to make integration guides easier to discover.

Changes:

Add a new TRL integration doc page with an SFTTrainer snippet and configuration example.
Add an end-to-end examples/trl-integration.py script intended to run quickly with a tiny test model.
Rename Integration section sidebar titles for better discoverability and add the TRL page to the toctree.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
`examples/trl-integration.py`	Adds a runnable TRL SFT example configured to report to Trackio.
`docs/source/trl_integration.md`	New TRL integration documentation page mirroring the Transformers guide structure.
`docs/source/_toctree.yml`	Updates Integration section titles and includes the new TRL integration page.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

abidlabs · 2026-04-27T16:15:06Z

+#   "trl>=1.2.0",
+#   "datasets>=4.4.0",
+#   "transformers[torch]>=5.0.0rc2",
+#   "huggingface_hub>=1.0.0",


Good catch — removed. Also dropped datasets and transformers[torch] since trl already pulls them in transitively.

qgallouedec

cool!

qgallouedec · 2026-04-27T16:12:11Z

+#   "datasets>=4.4.0",
+#   "transformers[torch]>=5.0.0rc2",


I'm not sure this is needed: trl already depends on datasets, transformers and torch

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

qgallouedec

actually wait!

Addresses Copilot's note that huggingface_hub is unused, and qgallouedec's note that datasets/transformers/torch are already pulled in via trl. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

abidlabs · 2026-04-27T16:16:55Z

Thanks so much @qgallouedec for the cleanup!

abidlabs · 2026-04-27T16:20:01Z

Confirmed example runs locally for me, merging when CI is green to get the docs live

docs: add TRL integration guide and rename integration sidebar titles

669fd89

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

abidlabs commented Apr 27, 2026

View reviewed changes

Comment thread docs/source/trl_integration.md Outdated

Apply suggestion from @abidlabs

f40031c

abidlabs marked this pull request as ready for review April 27, 2026 16:05

abidlabs requested review from Saba9, Copilot, qgallouedec and znation April 27, 2026 16:06

Copilot started reviewing on behalf of abidlabs April 27, 2026 16:06 View session

Copilot AI reviewed Apr 27, 2026

View reviewed changes

qgallouedec approved these changes Apr 27, 2026

View reviewed changes

Comment thread docs/source/trl_integration.md Outdated

Comment thread examples/trl-integration.py Outdated

Comment thread examples/trl-integration.py Outdated

Comment thread examples/trl-integration.py Outdated

qgallouedec reviewed Apr 27, 2026

View reviewed changes

abidlabs and others added 4 commits April 27, 2026 09:13

Update docs/source/trl_integration.md

fbf82b0

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

Update examples/trl-integration.py

3ba9c47

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

Update examples/trl-integration.py

4c1ab0d

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

Update examples/trl-integration.py

d852324

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

qgallouedec requested changes Apr 27, 2026

View reviewed changes

trim trl example deps to trackio + trl (transitive deps come from trl)

adaeee3

Addresses Copilot's note that huggingface_hub is unused, and qgallouedec's note that datasets/transformers/torch are already pulled in via trl. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

qgallouedec approved these changes Apr 27, 2026

View reviewed changes

Comment thread examples/trl-integration.py Outdated

Apply suggestion from @qgallouedec

cd1747e

Co-authored-by: Quentin Gallouédec <45557362+qgallouedec@users.noreply.github.com>

abidlabs merged commit e3642f6 into main Apr 27, 2026
10 checks passed

Conversation

abidlabs commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gradio-pr-bot commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🪼 branch checks and previews

Uh oh!

gradio-pr-bot commented Apr 27, 2026

🦄 no changes detected

This Pull Request does not include changes to any packages.

Something isn't right?

Uh oh!

HuggingFaceDocBuilderDev commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🪼 branch checks and previews

Uh oh!

HuggingFaceDocBuilderDev commented Apr 27, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

abidlabs Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

qgallouedec left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

qgallouedec Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

qgallouedec left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

abidlabs commented Apr 27, 2026

Uh oh!

abidlabs commented Apr 27, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

abidlabs commented Apr 27, 2026 •

edited

Loading

gradio-pr-bot commented Apr 27, 2026 •

edited

Loading

HuggingFaceDocBuilderDev commented Apr 27, 2026 •

edited

Loading