File size: 1,638 Bytes
7a5c845 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 | # MEV Annotation Toolkit
This directory contains the code used to generate multi-event video annotations.
## Layout
- `qwen/`: local Qwen3-VL annotation, event segmentation, and camera-motion classification scripts.
- `gemini/`: Gemini API wrappers that reuse the Qwen annotation pipeline schema and post-processing.
- `scripts/multi-event/`: shell launchers for batched multi-GPU annotation runs.
Generated annotations, logs, checkpoints, and datasets are intentionally not included. Keep them under local runtime directories such as `data/`, `annotations/`, `logs/`, and `checkpoints/`.
## Basic Usage
Run Qwen annotation on segmented videos:
```bash
bash scripts/multi-event/run_multi_event_annotations.sh data/example_segments annotations/qwen/multi_event/output.json --resume
```
Run Gemini annotation:
```bash
export GEMINI_API_KEY=your_api_key
python gemini/generate_multi_event_annotations.py --input data/example_segments --output annotations/gemini/multi_event/output.json --recursive --resume
```
Segment a single video into event intervals:
```bash
python qwen/segment_events_qwen3vl.py data/video.mp4 --output annotations/segments/video_events.json
```
Classify camera motion for a single video:
```bash
python qwen/classify_camera_motion_qwen3vl.py data/video.mp4 --output annotations/camera/video_camera.json
```
## Notes
- The Qwen scripts expect a local model checkpoint via `--model-path` or `MODEL_PATH`.
- The shell launchers derive all paths from this directory and environment variables.
- `ffmpeg` and `ffprobe` must be available on `PATH`.
- Gemini scripts use `GEMINI_API_KEY` or `GOOGLE_API_KEY`.
|