Skip to content

Troubleshooting

App Fails to Start

  • Confirm your environment is active.
  • Reinstall dependencies:
pip install -r requirements.txt

Dataset JSON Does Not Load

  • Confirm the file is valid JSON.
  • Confirm the root value is a JSON object, not an array.
  • Confirm top-level data is a list.
  • Check the expected structure in OSL JSON Format.

Legacy VQA files that use top-level questions and per-answer question_id entries should be converted before editing:

python tools/convert_legacy_vqa_to_grouped.py \
  --input-json old_vqa.json \
  --output-json grouped_vqa.json

Large Dataset Is Still Populating

Datasets with thousands of samples keep the left explorer bounded to the page size configured under Edit → Settings… → Dataset Explorer (500 by default). The range below the tree shows which samples are visible. Scroll down again at the bottom for the next page or up at the top for the previous page. The bottom page field and arrow buttons also support direct navigation. Filtering rebuilds pages from all matching samples; it does not discard data. The JSON inspector and classification batch-range lists are intentionally prepared only when opened so they do not delay project loading. An active sample can continue playing while its row is off-page.

Media Files Are Missing After Loading

Relative paths in data[].inputs[].path are resolved from the directory that contains the dataset JSON. If the JSON was moved separately from its media folders, move the folders back beside the JSON or update the paths.

Saving can repair path layout

After opening a dataset from the intended folder, Save Dataset As can rewrite input paths relative to the new JSON location.

Hugging Face Transfer Errors

  • Ensure huggingface_hub is installed.
  • Authenticate if dataset access is gated:
huggingface-cli login
  • For upload failures:
  • Repository Not Found: create the repo or let the app create it from the prompt.
  • Revision/Branch Not Found: create the branch or let the app create it from the prompt.

Download URL 404 / Not Found

  • Verify the repo ID, revision, split, and format in the dialog.
  • JSON mode expects <split>.json.
  • Parquet mode expects a <split>/ folder.
  • If a previously successful URL is now invalid, reselect or correct it in the dialog.

Video Playback Error or Black Screen

Some codecs are not decoded by your platform backend. Convert to H.264/AAC MP4:

ffmpeg -i input.mp4 -vcodec libx264 -acodec aac output.mp4

No Playback After Selecting a Row

If the selected input is not playable media for the current backend, the row can stay selected while playback does not start. For example, frames_npy and tracking_parquet inputs use specialized renderers, and unsupported text or metadata files are not played as video. player_joints_h5 and player_centroids_h5 inputs require a valid timestamp_utc column because playback timing is derived from absolute UTC timestamps.