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
bash
export GEMINI_API_KEY="your-key" # Get from https://aistudio.google.com/apikey pip install google-genai python-dotenv pillow
Quick Commands
Transcribe Audio:
bash
python scripts/gemini_batch_process.py --files audio.mp3 --task transcribe --model gemini-2.5-flash
Analyze Image:
bash
python scripts/gemini_batch_process.py --files image.jpg --task analyze --prompt "Describe this" --output output.md
Process Video:
bash
python scripts/gemini_batch_process.py --files video.mp4 --task analyze --prompt "Summarize with timestamps"
Extract from PDF:
bash
python scripts/gemini_batch_process.py --files doc.pdf --task extract --prompt "Extract tables as JSON" --format json
Generate Image:
bash
python scripts/gemini_batch_process.py --task generate --prompt "A futuristic city" --model gemini-2.5-flash-image
Model 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
bash
command -v gemini || which gemini
Quick Commands
Code Generation:
bash
gemini "Create [description]. Output complete file." --yolo -o text
Code Review:
bash
gemini "Review [file] for bugs and security issues" -o text
Web Research:
bash
gemini "What are the latest [topic]? Use Google Search." -o text
Architecture Analysis:
bash
gemini "Use codebase_investigator to analyze this project" -o text
Faster Model:
bash
gemini "[prompt]" -m gemini-2.5-flash -o text
Key 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
bash
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:
bash
python scripts/run.py notebook_manager.py list
Add Notebook:
bash
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:
bash
python scripts/run.py ask_question.py --question "Your question" --notebook-id ID
Search Notebooks:
bash
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.md - •
references/vision-understanding.md - •
references/video-analysis.md - •
references/document-extraction.md - •
references/image-generation.md
Gemini CLI
- •
references/gemini-reference.md - •
references/gemini-patterns.md - •
references/gemini-templates.md - •
references/gemini-tools.md
NotebookLM
- •
references/notebooklm-api.md - •
references/notebooklm-troubleshooting.md - •
references/notebooklm-usage.md