LayoutLens Documentation¶
LayoutLens is a production-ready AI-powered UI testing framework that enables natural language visual testing. It captures screenshots using Playwright and analyzes them with OpenAI’s GPT-4 Vision API to validate layouts, accessibility, responsive design, and visual consistency.
Key Achievement: 95.2% accuracy on professional ground truth benchmark suite.
🚀 Quick Start¶
pip install layoutlens
playwright install chromium
export OPENAI_API_KEY="your-key"
from layoutlens import LayoutLens
tester = LayoutLens()
result = tester.test_page("page.html", queries=["Is the layout responsive?"])
print(f"Success rate: {result.success_rate:.1%}")
✨ Key Features¶
Natural Language Testing: Ask questions like “Is the button properly aligned?”
Multi-Viewport Support: Test across mobile, tablet, and desktop
Comprehensive Benchmarks: 31 test cases across 9 UI categories
95.2% Accuracy: Validated on professional ground truth suite
CI/CD Ready: GitHub Actions and Jenkins integration
📖 Documentation¶
API Reference
📊 Performance Metrics¶
✅ 95.2% accuracy on ground truth benchmark suite
✅ 31 HTML test files across 9 specialized categories
✅ ~23 seconds average processing time per test
✅ Multi-viewport testing with responsive design validation
✅ Production ready with professional documentation