Skip to content

Document the robotics Video Preview card - #2775

Open
epence12 wants to merge 1 commit into
huggingface:mainfrom
epence12:document-robotics-video-preview
Open

Document the robotics Video Preview card#2775
epence12 wants to merge 1 commit 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 or security impact.

Overview
Adds documentation for how robotics model pages show a Video Preview card instead of the usual inference widget.

The new section explains that the UI only checks for replay.mp4 at the repo root on main (not widget metadata or example outputs), what happens when the file is missing, Git LFS tracking, and links an example repo. Widget Availability and Provider Support now points robotics authors to that section instead of only example outputs.

Reviewed by Cursor Bugbot for commit 48219ec. 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
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.

1 participant