Gemini Reader
Analyze local PDF, video, and audio files via Gemini API (Python SDK google-genai).
Prerequisites
google-genaiPython package installed (pip install google-genai)GEMINI_API_KEYenvironment variable set- Supported: PDF, video (mp4/webm/mov/avi/mkv), audio (mp3/wav/m4a/ogg)
Usage
python3 scripts/gemini_read.py <file> "<prompt>" [--model MODEL] [--output PATH]
Examples
# Summarize a PDF
python3 scripts/gemini_read.py paper.pdf "用中文总结这篇论文的主要内容"
# Analyze a video
python3 scripts/gemini_read.py lecture.mp4 "列出这个视频的关键要点"
# Transcribe audio
python3 scripts/gemini_read.py recording.m4a "转录这段音频的内容"
# Save output to file
python3 scripts/gemini_read.py report.pdf "提取所有数据表格" --output tables.txt
Model selection
| Alias | Full name | Best for |
|---|---|---|
3-flash (default) |
gemini-3-flash-preview | Fast, cheap, everyday use |
2.5-flash |
gemini-2.5-flash | Stable, good balance |
2.5-pro |
gemini-2.5-pro | Deep analysis, long docs |
3-pro |
gemini-3-pro-preview | Advanced reasoning |
3.1-pro |
gemini-3.1-pro-preview | Latest pro capabilities |
Use alias with -m: gemini_read.py file.pdf "prompt" -m 2.5-pro
Notes
- All files go through File Upload API (upload → generate → cleanup), unified flow regardless of size
- For files on remote nodes (e.g. Mac), transfer to VM first using Tailscale or scp
- The script auto-detects MIME type from file extension
- API calls are direct — no sandbox restrictions, no CLI overhead
- Requires
GEMINI_API_KEYenv var orgoogle-genaiconfigured auth