feat: Migrate to google-genai SDK, fix vulnerability, and add examples

examples/README.md

@@ -0,0 +1,139 @@
+# AnimaWatch Examples
+
+Example scripts demonstrating how to use AnimaWatch programmatically.
+
+## Prerequisites
+
+1. Install AnimaWatch and its dependencies:
+   ```bash
+   cd ~/github/animawatch
+   uv sync
+   uv run playwright install chromium
+   ```
+
+2. Set up your Gemini API key (free):
+   ```bash
+   export GEMINI_API_KEY="your-api-key-here"
+   ```
+   Get a free key at [Google AI Studio](https://aistudio.google.com/).
+
+## Examples
+
+### 1. Basic Animation Check
+
+Records a webpage and analyzes it for animation issues.
+
+```bash
+uv run python examples/basic_animation_check.py
+```
+
+**What it does:**
+- Opens a browser and navigates to a URL
+- Records for 3 seconds to capture animations
+- Sends the video to Gemini for analysis
+- Reports any jank, stuttering, or timing issues
+
+### 2. Screenshot Analysis
+
+Takes a screenshot and analyzes it for visual/design issues.
+
+```bash
+uv run python examples/screenshot_analysis.py
+```
+
+**What it does:**
+- Captures a full-page screenshot
+- Analyzes layout, colors, and typography
+- Reports issues with recommendations
+
+### 3. Accessibility Check
+
+Checks a webpage for visual accessibility issues.
+
+```bash
+uv run python examples/accessibility_check.py
+```
+
+**What it does:**
+- Captures a full-page screenshot
+- Analyzes for WCAG accessibility issues
+- Reports contrast, readability, and touch target problems
+- Provides an overall accessibility rating
+
+## Customizing Examples
+
+Edit the URL in any example's `main()` function:
+
+```python
+async def main() -> None:
+    url = "https://your-website.com"  # Change this
+    # ...
+```
+
+## Using with Ollama (100% Local)
+
+To run without any API calls:
+
+```bash
+# Install and start Ollama
+brew install ollama
+ollama serve
+
+# Pull a vision model
+ollama pull qwen2.5-vl:7b
+
+# Configure environment
+export VISION_PROVIDER=ollama
+export OLLAMA_MODEL=qwen2.5-vl:7b
+
+# Run example
+uv run python examples/screenshot_analysis.py
+```
+
+**Note**: Ollama doesn't support direct video analysis, so `basic_animation_check.py` 
+will not work with Ollama. Use screenshot-based examples instead.
+
+## Writing Your Own Scripts
+
+```python
+import asyncio
+from animawatch.browser import BrowserRecorder
+from animawatch.vision import get_vision_provider
+
+async def my_analysis():
+    browser = BrowserRecorder()
+    vision = get_vision_provider()
+
+    try:
+        await browser.start()
+
+        # Record with actions
+        video_path = await browser.record_interaction(
+            url="https://example.com",
+            actions=[
+                {"type": "click", "selector": ".menu-button"},
+                {"type": "wait", "duration": 1.0},
+            ],
+            wait_time=2.0,
+        )
+
+        # Analyze
+        result = await vision.analyze_video(video_path, "Check for animation issues")
+        print(result)
+
+    finally:
+        await browser.stop()
+
+asyncio.run(my_analysis())
+```
+
+## Available Actions for Recording
+
+| Action | Parameters | Description |
+|--------|------------|-------------|
+| `click` | `selector` | Click an element |
+| `type` | `selector`, `text` | Type text into input |
+| `scroll` | `x`, `y` | Scroll by pixels |
+| `hover` | `selector` | Hover over element |
+| `wait` | `duration` | Wait for seconds |
+

examples/accessibility_check.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""Example: Accessibility Check with AnimaWatch.
+
+This example demonstrates how to use AnimaWatch to check
+a webpage for visual accessibility issues like color contrast,
+readability, and touch target sizes.
+"""
+
+import asyncio
+
+from animawatch.browser import BrowserRecorder
+from animawatch.config import settings
+from animawatch.vision import get_vision_provider
+
+
+async def check_accessibility(url: str) -> str:
+    """Check a webpage for visual accessibility issues.
+
+    Args:
+        url: The webpage URL to check
+
+    Returns:
+        The accessibility analysis result
+    """
+    from pathlib import Path
+
+    browser = BrowserRecorder()
+    vision = get_vision_provider()
+    screenshot_path: Path | None = None
+
+    try:
+        await browser.start()
+
+        # Take full-page screenshot
+        print(f"📸 Capturing {url}...")
+        screenshot_path = await browser.take_screenshot(url, full_page=True)
+
+        # Analyze for accessibility
+        print("♿ Checking accessibility...")
+        prompt = """You are an accessibility expert reviewing a webpage.
+
+Check for these visual accessibility issues:
+
+1. **Color Contrast**
+   - Text/background contrast ratios
+   - Low contrast UI elements
+
+2. **Text Readability**
+   - Font sizes (minimum 16px for body)
+   - Line height and spacing
+   - Font weight and clarity
+
+3. **Touch Targets**
+   - Button/link sizes (minimum 44x44px)
+   - Spacing between interactive elements
+
+4. **Focus Indicators**
+   - Visible focus states
+   - Skip links
+
+5. **Visual Hierarchy**
+   - Heading structure clarity
+   - Information organization
+
+6. **Motion Concerns**
+   - Animations that could cause vestibular issues
+   - Flashing content
+
+Rate overall accessibility (A, AA, AAA, or Failing) and provide specific recommendations.
+"""
+
+        analysis = await vision.analyze_image(screenshot_path, prompt)
+
+        return str(analysis)
+
+    finally:
+        # Clean up temp screenshot
+        if screenshot_path is not None and screenshot_path.exists():
+            screenshot_path.unlink()
+        await browser.stop()
+
+
+async def main() -> None:
+    """Run the example."""
+    url = "https://example.com"
+
+    print("=" * 60)
+    print("♿ AnimaWatch - Accessibility Check Example")
+    print("=" * 60)
+    print()
+    print(f"URL: {url}")
+    print(f"Vision Provider: {settings.vision_provider}")
+    print()
+
+    try:
+        result = await check_accessibility(url)
+        print()
+        print("=" * 60)
+        print("📊 ACCESSIBILITY REPORT")
+        print("=" * 60)
+        print(result)
+    except Exception as e:
+        print(f"❌ Error: {e}")
+        raise
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/basic_animation_check.py

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+"""Example: Basic Animation Check with AnimaWatch.
+
+This example demonstrates how to use AnimaWatch programmatically
+to check animations on a webpage without running as an MCP server.
+"""
+
+import asyncio
+from pathlib import Path
+
+from animawatch.browser import BrowserRecorder
+from animawatch.config import settings
+from animawatch.vision import get_vision_provider
+
+
+async def check_animations(url: str, output_dir: Path | None = None) -> str:
+    """Record and analyze animations on a webpage.
+
+    Args:
+        url: The webpage URL to analyze
+        output_dir: Optional directory to save the recording
+
+    Returns:
+        The analysis result from the vision AI
+    """
+    # Initialize browser recorder and vision provider
+    browser = BrowserRecorder()
+    vision = get_vision_provider()
+    video_path: Path | None = None
+
+    try:
+        # Start the browser
+        await browser.start()
+
+        # Record the page (waits 3 seconds for animations)
+        print(f"🎬 Recording {url}...")
+        video_path = await browser.record_interaction(
+            url=url,
+            actions=None,  # No specific actions, just watch
+            wait_time=3.0,
+            video_dir=output_dir,
+        )
+        print(f"✅ Recording saved: {video_path}")
+
+        # Analyze with vision AI
+        print("🔍 Analyzing with vision AI...")
+        prompt = """Analyze this video for animation issues:
+- Jank or stuttering
+- Timing problems
+- Visual artifacts
+- Layout shifts
+
+Report any issues with timestamps and severity."""
+
+        analysis = await vision.analyze_video(video_path, prompt)
+
+        return str(analysis)
+
+    finally:
+        # Clean up temp video if no output dir specified
+        if output_dir is None and video_path is not None and video_path.exists():
+            video_path.unlink()
+        # Always clean up browser
+        await browser.stop()
+
+
+async def main() -> None:
+    """Run the example."""
+    # Example URL - replace with your own
+    url = "https://example.com"
+
+    print("=" * 60)
+    print("🎬 AnimaWatch - Basic Animation Check Example")
+    print("=" * 60)
+    print()
+    print(f"URL: {url}")
+    print(f"Vision Provider: {settings.vision_provider}")
+    print(f"Vision Model: {settings.vision_model}")
+    print()
+
+    try:
+        result = await check_animations(url)
+        print()
+        print("=" * 60)
+        print("📊 ANALYSIS RESULT")
+        print("=" * 60)
+        print(result)
+    except Exception as e:
+        print(f"❌ Error: {e}")
+        raise
+
+
+if __name__ == "__main__":
+    asyncio.run(main())