Skip to content

Document the robotics Video Preview card - #2775

Open
epence12 wants to merge 2 commits into
huggingface:mainfrom
epence12:document-robotics-video-preview
Open

epence12 wants to merge 2 commits into
huggingface:mainfrom
epence12:document-robotics-video-preview

Conversation

@epence12

@epence12 epence12 commented Sep 10, 2026 •

Copy link
Copy Markdown

Documents how the Video Preview card on robotics model pages is populated. This is not covered by the current widget metadata spec, and the existing guidance points readers toward example outputs, which the card ignores.

  • Add a "Video previews for robotics models" section covering the replay.mp4 lookup at the repository root on main, the "Preview not found" fallback, and the fact that widget metadata is not read.
  • Note the Git LFS tracking rule and link lerobot/diffusion_pusht as a repository with the file in place.
  • Flag the robotics exception in "Widget Availability and Provider Support", where models without provider support are currently pointed at example outputs.

Validation: Checked against the widget bundle served on model pages, which issues a single HEAD request for /{model_id}/resolve/main/replay.mp4 and falls back to "Preview not found" when that returns an error. widget entries using output.url, src, and both together were tested on a scratch robotics repo and none of them populated the card. A repository with replay.mp4 at the root rendered the video as described. This covers the robotics card only, not the other task widgets.

Related: huggingface/huggingface.js#722 and huggingface/lerobot#227.

Assisted by Claude Code


Note

Low Risk
Documentation-only change with no runtime, auth, or data-handling impact.

Overview
Adds a Video previews for robotics models section to the Hub widgets docs, placed after the example-outputs gallery and before widget availability.

The new text explains that pipeline_tag: robotics model pages use a Video Preview card instead of the normal inference widget, that widget metadata (including output.url) is ignored, and that the UI loads a single fixed asset: replay.mp4 at the repository root on main, with inline looping playback or a "Preview not found" message when the file is absent. It also documents Git LFS tracking for replay.mp4 and points to lerobot/diffusion_pusht as a working example.

Reviewed by Cursor Bugbot for commit b80b85d. Bugbot is set up for automated code reviews on this repo. Configure here.

@epence12
epence12 force-pushed the document-robotics-video-preview branch from 0c55e8e to 48219ec Compare September 10, 2026 07:08
Comment thread docs/hub/models-widgets.md Outdated
The list of all providers and the tasks they support is available in [this documentation page](https://huggingface.co/docs/inference-providers/index#partners).

For models without provider support, you can still showcase functionality using [example outputs](#example-outputs) in your model card.
For models without provider support, you can still showcase functionality using [example outputs](#example-outputs) in your model card. Robotics models are an exception, see [Video previews for robotics models](#video-previews-for-robotics-models).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no need for that precision here imo

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fair and now addressed @julien-c

Removed mention of robotics models exception in documentation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants