Analyze Video

Analyze a video file with Gemini and return a structured markdown report.

Prerequisites

• Python 3.10+
• google-genai installed globally (any Python the shell finds via python3 works — verified working at version 1.64.0)
• GEMINI_API_KEY set in the user's shell environment (e.g. exported in ~/.zshrc)

Steps

1. Parse the arguments from $ARGUMENTS:

   • video path (required) — path to the video file
   • --prompt (optional) — custom analysis prompt; defaults to a structured-report prompt with anti-hallucination rules
   • --fps (optional) — custom frame sampling rate (useful for catching sub-second cuts in fast-paced footage)
   • --model (optional) — Gemini model ID; defaults to gemini-3-flash-preview

2. Verify the video file exists at the given path. If not, report the error and stop.