kbarbel640-del Image Optimizer
Your images are 5MB each and nobody noticed until Lighthouse screamed. This tool scans your images and tells you exactly what to optimize.
One command. Zero config. Just works.
Quick Start
npx ai-image-optimize ./public/images/
What It Does
- Scans image directories for optimization opportunities
- Identifies oversized images
- Suggests format conversions (PNG to WebP, etc.)
- Recommends responsive image strategies
Usage Examples
# Scan images directory
npx ai-image-optimize ./public/images/
# Scan assets folder
npx ai-image-optimize ./assets/
# Get detailed report
npx ai-image-optimize ./public/ --verbose
Best Practices
- Use WebP - smaller than PNG/JPEG with same quality
- Serve responsive images - don't send desktop images to mobile
- Lazy load below the fold - defer loading offscreen images
- Compress aggressively - 80% quality is usually fine
When to Use This
- Lighthouse says images are too big
- Page load times are slow
- Want to audit image usage
- Planning an optimization sprint
Part of the LXGIC Dev Toolkit
This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.
Find more:
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgicstudios.com
Requirements
No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.
npx ai-image-optimize --help
How It Works
Scans your image files, collects metadata like size, dimensions, and format. Sends the analysis to GPT-4o-mini which provides prioritized optimization recommendations.
License
MIT. Free forever. Use it however you want.