Skip to content

Instruction-Paired Demonstration Datasets

By Noah Loul · Reviewed by Noah Loul · Updated

  1. 01Your data spec
  2. 02Matched to businesses
  3. 03Rights and samples reviewed
  4. 04Licensed delivery
How it works with SourceX: Your data spec → Matched to businesses → Rights and samples reviewed → Licensed delivery.Illustrative

Short answer

An instruction-paired demonstration dataset links each recorded task, or each step within it, to the instruction it carries out: an SOP step, a work-instruction card, live narration or an annotator's caption. Businesses that hold both procedures and video of the same tasks are the main existing source, with alignment usually added afterwards. The pairs support video-language pretraining, step recognition, planning and instruction-following evaluation, not motor control.

Why pairing is worth paying for

Unpaired footage tells a model what work looks like. Paired footage tells it which words describe which segment, which is what language-conditioned policies, planners and video-language models train on.

Published representation work leans on that link. R3M combined time-contrastive learning with a video-language alignment objective when pretraining on Ego4D human video (Nair et al., 2022), and Voltron learned language-driven representations from human videos and their captions (Karamcheti et al., 2023). For instruction following, ALFRED paired expert demonstrations with 25,000 natural-language directives that give both a high-level goal and low-level step instructions (Shridhar et al., 2019). A business SOP with matching step video has the same two-level shape: a task goal and an ordered list of steps.

Five kinds of pairing

PairingWhere it comes fromAlignmentTypical weakness
Live narrationSpoken during the taskTight when spoken at the momentInformal wording; silence when the worker is busy
Procedure to videoAn SOP or work instruction plus video of the same taskDocument step to video segment, added by annotationVideo may follow a different revision or skip steps
Post-hoc captionsAnnotators describe segments afterwardsSet by the guidelineCost; vocabulary drift between annotators
Illustrated instructionsInstruction cards and manuals with a photo per stepImage to step text, already pairedStill images, no motion
Voiceover in edited videoNarration track of training videosLooseOften describes something other than the frame on screen

Each has published precedents. EPIC-KITCHENS-100 collected "pause-and-talk" narration and then transcribed, parsed and temporally segmented it (Damen et al., 2020). Ego-Exo4D recorded expert commentary alongside skilled activities (Grauman et al., 2023). COIN annotated a hierarchy of tasks and step-level descriptions with temporal boundaries (Tang et al., 2019).

Loose voiceover is the cheapest and the noisiest. HowTo100M paired clips with automatically transcribed narration and no manual annotation (Miech et al., 2019); later work found much of that narration did not match what was visible.

Where existing paired assets live

The most promising suppliers are businesses where a documentation or quality team maintains procedures and a training team films the same tasks:

  • Manufacturers with controlled work instructions and line-training video.
  • Food-service and franchise operators with recipe and prep cards plus prep videos.
  • Facility services and housekeeping contractors with cleaning SOPs and onboarding video.
  • Laboratories with method SOPs and recorded training.
  • Field service organizations with service procedures and recorded jobs.
  • Users of connected-worker platforms, where each step may already store text, photos and short clips.

In most of these, the two halves live in different systems owned by different teams. Pairing is usually something you add, not something you receive. For the training-video half, use the corporate training video archive checklist.

Illustrative package contents

# Illustrative only — one paired record and the package around it; names and values are synthetic
record:
  pair_id: pair_000431
  task_id: task_case_sealing
  procedure: {doc_id: SOP-PK-017, revision: C, step_index: 4,
              step_text: "Fold the minor flaps, then the major flaps, and seal the seam with one strip of tape."}
  video: {clip_id: clip_site02_0193, start_s: 41.2, end_s: 53.8, camera: head_mounted, fps: 30}
  alignment: {source: annotator, guideline: v1.2, reviewer: annot_B07, confidence: high}
  deviation: "taped before folding the second major flap; corrected at 50.1 s"
  narration: null
  outcome: completed
package:
  procedures: PDF originals + structured step lists, with revision dates
  video: source-resolution clips with constant frame rate
  alignment_file: one row per step instance, including steps with no visible segment
  deviation_notes: skipped, reordered, repeated and added steps
  docs: annotation guideline, agreement report, rights summary per document and per clip
excluded: robot actions, joint states, forces (not present in either source)

The field-level alignment specification, including how to mark partial and missing matches, is owned by SOP-to-video step alignment. Captions written by annotators follow language annotations for demonstrations.

What the pairs can and cannot support

Can support: video-language pretraining; step recognition and localization; task-progress estimation; grounding a planner's step vocabulary in real footage; evaluation sets that test whether a model can follow, order or verify instructions; detection of skipped or reordered steps when deviations are labeled.

Cannot support: low-level control. Neither the document nor the video contains joint states, actions or forces, and the text describes the intended procedure rather than the motion. What SOPs can and cannot teach a humanoid sets out that boundary.

Quality and acceptance checks

  • Revision match. The procedure revision in force when each clip was recorded is identified. Mismatches are the main source of false pairs; see procedural drift.
  • Step coverage. A buyer-set share of procedure steps has a matched segment, and unmatched steps are listed, not dropped.
  • Agreement. A second annotator aligns a random subset; boundary disagreement stays within a tolerance you set.
  • Deviation labels. Skipped, reordered and repeated steps are marked, so the data does not teach that every execution matches the text.
  • Visibility. For each step, the state change it describes is visible in the segment.
  • Held-out split. Evaluation pairs are separated by site, procedure or performer, depending on the claim you want to test.

Limitations and preparation

Most paired data is built, not found. Expect to structure PDF procedures into steps, match revisions to recording dates, align and review, and write language for steps that the document leaves implicit. Narration recorded during the task, as in narrated demonstrations, is often more faithful to what happened than a document written for a different purpose.

Questions to ask suppliers

  1. Do the procedures and the videos cover the same tasks at the same sites?
  2. Which procedure revision was in force when each video was recorded?
  3. Are procedures structured into numbered steps, or free text and images?
  4. Is narration recorded live, scripted afterwards, or absent?
  5. Do videos show every step, or only the ones a trainer chose to film?
  6. Are deviations from the procedure visible and, if so, are they ever corrected on camera?
  7. Who owns the procedures, and were any copied from equipment makers or consultants?
  8. Who appears in the videos, and do their releases extend to licensing for AI training?

Permissions and provenance

Paired data has two rights chains. Procedures may contain proprietary parameters or text adapted from equipment manuals, and video involves the people recorded. Clear both before pairing, since alignment work on content you cannot license is wasted.

For ownership of procedure text, see who owns a procedure; for people on camera, see worker consent and identifiable people. This is not legal advice.

Discuss your requirements

If you need instruction-paired data, tell SourceX which tasks, pairing type and alignment granularity you need. SourceX looks for US businesses that hold both procedures and video, checks the data and the supplier's licensing permissions, and coordinates the license and delivery. SourceX's role is sourcing, rights review, licensing and delivery coordination; it can also arrange annotation, scoped case by case. A request does not guarantee a match; SourceX follows up about potential sources.

See also the workplace task demonstration hub, the humanoid training data guide, and the catalog pages on licensing SOPs and playbooks and video recordings.

Describe the workplace demonstration data your robotics project needs

Sources

Frequently asked questions

What is an instruction-paired demonstration dataset, and where do its pairs come from?

An instruction-paired dataset links each recorded task, or each step within it, to the instruction it carries out, such as an SOP step or live narration. Businesses holding both procedures and video of the same tasks are the main existing source, with alignment usually added afterwards.

Why do paired demonstrations matter more than unpaired footage for language-conditioned models?

Unpaired footage shows what work looks like, while paired footage shows which words describe which segment. Language-conditioned policies, planners and video-language models train on that link, and a business SOP with matching step video has the same two-level shape: a goal and ordered steps.

Which checks should a buyer run on procedure-to-video pairs before using them?

Check that the procedure revision in force when each clip was recorded is identified, since mismatched revisions are the main source of false pairs. Also check that a buyer-set share of steps has a matched segment, with unmatched steps listed, and that skipped or reordered steps are labeled.

Describe the data your robots need

Describe the tasks, modalities and permitted uses you need. SourceX reviews the requirement and follows up about potential sources; a request does not guarantee a match.

Discuss your humanoid training-data requirements with SourceX
See if you qualify