By name: gem description: Multimodal AI processing and image generation using Google Gemini. Use for analyzing PDFs, images, videos, YouTube links, and other large documents. Also generates images with Gemini's image model. Ideal when you need to extract information from files that require vision or multimodal understanding, or generate images from text prompts.
Gemini Multimodal Tool
Use the ai-gem CLI tool for multimodal AI processing and image generation via Google's Gemini API.
Usage
# Text queries
ai-gem "Write a haiku about Python programming"
# Analyze documents
ai-gem "Summarize this document" document.pdf
# Analyze images
ai-gem "What's in this image?" photo.jpg
# Process YouTube videos
ai-gem "Create a 5-point summary" "https://youtu.be/VIDEO_ID"
# Compare multiple files
ai-gem "Compare these files" file1.pdf file2.png
# Web search
ai-gem "Current AI news" --search
# Generate images (uses gemini-3.1-flash-image-preview by default)
ai-gem --image "A cute robot reading a book in a cozy library"
ai-gem --image "A landscape at sunset" --aspect-ratio 16:9
ai-gem --image "A cat wearing a hat" -o cat.png
ai-gem --image "Edit this to add sunglasses" reference.jpg
# Use alternative image model
ai-gem --image "A blue triangle" -m gemini-2.5-flash-image
Image Generation Options
--image/-i: Generate an image instead of text--output/-o: Output file path (auto-generated if omitted)--aspect-ratio/-a: Aspect ratio (1:1, 9:16, 16:9, etc.)--model/-m: Override model (default: gemini-3.1-flash-image-preview)- Attachments serve as reference images for editing
Requirements
GEMINI_API_KEYenvironment variable must be set- The
hamelpackage must be installed:pip install hamel
Supported Input Types
- PDFs
- Images (PNG, JPEG, GIF, WebP)
- Videos (MP4, etc.)
- YouTube URLs
- Plain text files
- Multiple files for comparison