Google AI Tools
Unified integration for Google's AI ecosystem: Gemini API (multimodal), Gemini CLI, and NotebookLM.
Module Selection
| Need | Module | When to Use |
|---|---|---|
| Media Processing | Gemini API | Audio/image/video/PDF analysis, generation |
| Second Opinion | Gemini CLI | Code review, cross-validation, alternative perspective |
| Web Research | Gemini CLI | Current info via Google Search grounding |
| Doc-Grounded Q&A | NotebookLM | Questions from uploaded documents |
Gemini API (Multimodal)
Process audio, images, videos, documents, and generate images.
Prerequisites
export GEMINI_API_KEY="your-key" # Get from https://aistudio.google.com/apikey
pip install google-genai python-dotenv pillowQuick Commands
Transcribe Audio:
python scripts/gemini_batch_process.py --files audio.mp3 --task transcribe --model gemini-2.5-flashAnalyze Image:
python scripts/gemini_batch_process.py --files image.jpg --task analyze --prompt "Describe this" --output output.mdProcess Video:
python scripts/gemini_batch_process.py --files video.mp4 --task analyze --prompt "Summarize with timestamps"Extract from PDF:
python scripts/gemini_batch_process.py --files doc.pdf --task extract --prompt "Extract tables as JSON" --format jsonGenerate Image:
python scripts/gemini_batch_process.py --task generate --prompt "A futuristic city" --model gemini-2.5-flash-imageModel Selection
| Model | Use Case | Context |
|---|---|---|
| gemini-2.5-flash | General (best price/perf) | 1-2M tokens |
| gemini-2.5-pro | Highest quality | 1-2M tokens |
| gemini-2.5-flash-image | Image generation | - |
Supported Formats
- Audio: WAV, MP3, AAC, FLAC, OGG (up to 9.5 hrs)
- Images: PNG, JPEG, WEBP, HEIC (up to 3,600 images)
- Video: MP4, MOV, AVI, WebM (up to 6 hrs)
- Documents: PDF (up to 1,000 pages)
References: references/audio-processing.md, references/vision-understanding.md, references/video-analysis.md, references/document-extraction.md, references/image-generation.md
Gemini CLI
Orchestrate Gemini for code review, web search, and parallel tasks.
Verify Installation
command -v gemini || which geminiQuick Commands
Code Generation:
gemini "Create [description]. Output complete file." --yolo -o textCode Review:
gemini "Review [file] for bugs and security issues" -o textWeb Research:
gemini "What are the latest [topic]? Use Google Search." -o textArchitecture Analysis:
gemini "Use codebase_investigator to analyze this project" -o textFaster Model:
gemini "[prompt]" -m gemini-2.5-flash -o textKey Flags
--yolo/-y: Auto-approve tool calls-o text: Human-readable output-o json: Structured output-m gemini-2.5-flash: Faster model
When to Use
✅ Second opinion on code ✅ Current web information ✅ Codebase architecture analysis ✅ Parallel code generation
❌ Simple quick tasks ❌ Interactive refinement
References: references/gemini-reference.md, references/gemini-patterns.md, references/gemini-templates.md, references/gemini-tools.md
NotebookLM
Query uploaded documents with source-grounded answers.
Prerequisites
python scripts/run.py auth_manager.py status # Check auth
python scripts/run.py auth_manager.py setup # One-time setup (browser visible)Quick Commands
List Notebooks:
python scripts/run.py notebook_manager.py listAdd Notebook:
python scripts/run.py notebook_manager.py add \
--url "https://notebooklm.google.com/notebook/..." \
--name "Name" --description "What it contains" --topics "topic1,topic2"Ask Question:
python scripts/run.py ask_question.py --question "Your question" --notebook-id IDSearch Notebooks:
python scripts/run.py notebook_manager.py search --query "keyword"Critical Notes
- Always use
run.pywrapper - Handles venv automatically - Browser visible for auth - Required for Google login
- Follow-up questions - Don't stop at first answer
- Rate limit: 50 queries/day on free accounts
References: references/notebooklm-api.md, references/notebooklm-troubleshooting.md
Scripts Overview
Gemini API Scripts (in scripts/)
| Script | Purpose |
|---|---|
gemini_batch_process.py | Batch process media files |
media_optimizer.py | Prepare media for API limits |
document_converter.py | Convert docs to PDF |
NotebookLM Scripts (via run.py)
| Script | Purpose |
|---|---|
auth_manager.py | Authentication management |
notebook_manager.py | Library CRUD |
ask_question.py | Query interface |
cleanup_manager.py | Data cleanup |
Cost Optimization
Gemini API Pricing
| Model | Input | Output |
|---|---|---|
| 2.5 Flash | $1.00/1M | $0.10/1M |
| 2.5 Pro | $3.00/1M | $12.00/1M |
Token Rates
- Audio: 32 tokens/sec (1 min = 1,920 tokens)
- Video: ~300 tokens/sec
- PDF: 258 tokens/page
- Image: 258-1,548 tokens
Best Practices
- Use
gemini-2.5-flashfor most tasks - Use File API for files >20MB
- Optimize media before upload
- Process specific segments, not full videos
Error Handling
| Error | Solution |
|---|---|
| 401 | Check API key |
| 429 | Rate limit - wait or use flash model |
| ModuleNotFoundError | Use run.py wrapper |
| Auth fails | Browser must be visible |
References
Gemini API
references/audio-processing.mdreferences/vision-understanding.mdreferences/video-analysis.mdreferences/document-extraction.mdreferences/image-generation.md
Gemini CLI
references/gemini-reference.mdreferences/gemini-patterns.mdreferences/gemini-templates.mdreferences/gemini-tools.md
NotebookLM
references/notebooklm-api.mdreferences/notebooklm-troubleshooting.mdreferences/notebooklm-usage.md