| # Gradio Deployment Notes | |
| - `app.py` defines `build_interface()` and **only** launches the demo when run as `__main__`. Hugging Face imports the module to build the config, so expensive work (dataset download) happens lazily via `lru_cache` helpers. | |
| - Dataset paths follow the LeRobot layout (`data/chunk-000/...`, `videos/chunk-000/rgb/...`). Files are cached inside `dataset_cache/` by `snapshot_download`. | |
| - Default episode data is preloaded when the Blocks tree is constructed, so all widgets render immediately without calling the API. | |
| - User interactions run through `episode_dropdown.change` → `load_episode_payload`, which returns `[instruction, video_path, fig_x, ...]`. | |
| - `demo.queue().launch(show_api=False)` disables the “Use via API” panel (Gradio 5.7.0 had a schema bug with Plot outputs that broke API info). | |
| - If you need to expose the API again, make sure to upgrade to a Gradio release where plot schema serialization works, then set `show_api=True`. | |