| name | ai-tools |
| description | Google AI tools integration. Modules: Gemini API (multimodal: audio/image/video/PDF, 2M context), Gemini CLI (second opinions, Google Search, code review), NotebookLM (source-grounded Q&A). Capabilities: transcription, OCR, video analysis, image generation, web search, document queries. Actions: transcribe, analyze, extract, generate, query, search with Google AI. Keywords: Gemini, Gemini API, Gemini CLI, NotebookLM, audio transcription, image captioning, video analysis, PDF extraction, Google Search, second opinion, source-grounded, multimodal, web research. Use when: processing media files, needing second AI opinion, searching current web info, querying uploaded documents, generating images. |
| allowed-tools | ["Bash","Read","Write","Edit","Grep","Glob"] |
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"
pip install google-genai python-dotenv pillow
Quick Commands
Transcribe Audio:
python scripts/gemini_batch_process.py --files audio.mp3 --task transcribe --model gemini-2.5-flash
Analyze Image:
python scripts/gemini_batch_process.py --files image.jpg --task analyze --prompt "Describe this" --output output.md
Process 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 json
Generate Image:
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
command -v gemini || which gemini
Quick Commands
Code Generation:
gemini "Create [description]. Output complete file." --yolo -o text
Code Review:
gemini "Review [file] for bugs and security issues" -o text
Web Research:
gemini "What are the latest [topic]? Use Google Search." -o text
Architecture Analysis:
gemini "Use codebase_investigator to analyze this project" -o text
Faster Model:
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
python scripts/run.py auth_manager.py status
python scripts/run.py auth_manager.py setup
Quick Commands
List Notebooks:
python scripts/run.py notebook_manager.py list
Add 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 ID
Search Notebooks:
python scripts/run.py notebook_manager.py search --query "keyword"
Critical Notes
- Always use
run.py wrapper - 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-flash for 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
Resources
