Export a Studio selection

import os
from nomadic import NomadicAI

client = NomadicAI(api_key=os.environ["NOMADIC_API_KEY"])
studio = client.studio.get("STUDIO_ID")

# Example query: replace it with a scenario relevant to your Studio.
matches = client.studio.search(studio.id, "robot picks up an object", top_k=50)
if not matches.first(1):
    print("No matches to export for this query.")
else:
    selection = client.studio.select(studio.id).include(matches)
    print(selection.count())  # {'events': ..., 'videos': ...}

    job = selection.export()
    job.wait()  # Prints progress; the job ID remains available as job.id.
    downloaded = job.download("./studio-export")
    print(downloaded["output_dir"])
    print(downloaded["manifest"]["skipped_selection"])
    print(downloaded["manifest"]["coverage"])

selection = client.studio.select(studio.id).include(
    filters={"robot_action": "grasp"}
)

selection = selection.exclude(matches.first(1))  # Remove the first returned event, if any.
selection = selection.exclude(video_ids=["VIDEO_ID_TO_SKIP"])
print(selection.count())

studio-export/
├── events.jsonl
├── excluded.jsonl
├── videos.jsonl
└── sessions/
    └── <video-id>/
        ├── <source-video-file>
        └── <video-id>.mcap