adaptive-memory-multi-model-router 2.14.13 → 2.14.15

package/demo/3blue1brown_video.py

@@ -0,0 +1,285 @@
+#!/usr/bin/env python3
+"""
+A3M Router — 3Blue1Brown Style Explainer Video Generator
+
+Creates animated frames showing:
+1. The problem: expensive AI routing
+2. The solution: intelligent routing
+3. How it works: 12 signals
+4. Results: 76.43 score, 213x cheaper
+
+Usage:
+    python3 demo/3blue1brown_video.py
+"""
+
+import subprocess
+import json
+import sys
+import math
+import os
+
+# Check dependencies
+def check_deps():
+    try:
+        import matplotlib
+        import numpy
+        print("✅ matplotlib, numpy available")
+        return True
+    except ImportError as e:
+        print(f"❌ Missing: {e}")
+        print("Install: pip install matplotlib numpy pillow")
+        return False
+
+def run_command(cmd, cwd=None):
+    result = subprocess.run(cmd, shell=True, capture_output=True, text=True, cwd=cwd)
+    return result.returncode == 0, result.stdout, result.stderr
+
+# Frame definitions - each scene
+SCENES = [
+    {
+        "id": 1,
+        "title": "The AI Cost Problem",
+        "content": "Every AI query goes to GPT-4\n$10.02 per 1,000 queries",
+        "visual": "gpt4_cost_visual",
+        "duration": 3.0
+    },
+    {
+        "id": 2,
+        "title": "The Solution",
+        "content": "Route queries intelligently\nto the cheapest capable model",
+        "visual": "routing_diagram",
+        "duration": 3.0
+    },
+    {
+        "id": 3,
+        "title": "How A3M Routes",
+        "content": "12 signals → instant decision\n<1ms, no GPU needed",
+        "visual": "signals_animation",
+        "duration": 4.0
+    },
+    {
+        "id": 4,
+        "title": "The Result",
+        "content": "#1 on RouterArena\n76.43 accuracy at $0.047/1K",
+        "visual": "benchmark_reveal",
+        "duration": 3.0
+    },
+    {
+        "id": 5,
+        "title": "213x Cheaper",
+        "content": "vs GPT-5: $10.02 → $0.047\nSame quality, 1/213th the cost",
+        "visual": "cost_comparison",
+        "duration": 3.0
+    }
+]
+
+def generate_frame_matplotlib(scene_num, frame_num, total_frames, output_path):
+    """Generate a single frame using matplotlib"""
+    import matplotlib.pyplot as plt
+    import matplotlib.patches as patches
+    import numpy as np
+    
+    # 3Blue1Brown color scheme
+    bg_color = '#1a1a2e'
+    text_color = '#ffffff'
+    accent1 = '#00a8ff'  # Blue
+    accent2 = '#ff6b6b'  # Red
+    accent3 = '#4ecdc4'  # Teal
+    accent4 = '#ffe66d'  # Yellow
+    
+    fig, ax = plt.subplots(figsize=(16, 9), facecolor=bg_color)
+    ax.set_facecolor(bg_color)
+    ax.set_xlim(0, 16)
+    ax.set_ylim(0, 9)
+    ax.axis('off')
+    
+    if scene_num == 1:
+        # Scene 1: GPT-4 cost visualization
+        # Big "$10.02" in center
+        ax.text(8, 5.5, '$10.02', fontsize=120, color=accent2, 
+                ha='center', va='center', fontweight='bold', family='monospace')
+        ax.text(8, 3.5, 'per 1,000 queries', fontsize=36, color=text_color,
+                ha='center', va='center')
+        ax.text(8, 1.5, 'GPT-4o', fontsize=28, color=accent1,
+                ha='center', va='center', style='italic')
+        
+        # Animated circles representing money
+        progress = frame_num / total_frames
+        for i in range(int(progress * 20)):
+            x = 2 + (i % 5) * 3
+            y = 7.5 - (i // 5) * 0.8
+            circle = patches.Circle((x, y), 0.3, color=accent2, alpha=0.6)
+            ax.add_patch(circle)
+            
+    elif scene_num == 2:
+        # Scene 2: Routing diagram
+        ax.text(8, 7.5, 'A3M Router', fontsize=48, color=accent1,
+                ha='center', va='center', fontweight='bold')
+        
+        # Query box
+        rect = patches.FancyBboxPatch((1, 3.5), 3, 2, boxstyle="round,pad=0.1",
+                                       facecolor=accent3, edgecolor='white', linewidth=2)
+        ax.add_patch(rect)
+        ax.text(2.5, 4.5, 'Query', fontsize=24, color=bg_color,
+                ha='center', va='center', fontweight='bold')
+        
+        # Arrow
+        ax.annotate('', xy=(5.5, 4.5), xytext=(4, 4.5),
+                    arrowprops=dict(arrowstyle='->', color=accent1, lw=3))
+        
+        # Router box
+        rect = patches.FancyBboxPatch((5.5, 3), 4, 3, boxstyle="round,pad=0.1",
+                                       facecolor=accent1, edgecolor='white', linewidth=3)
+        ax.add_patch(rect)
+        ax.text(7.5, 5, 'A3M', fontsize=28, color=text_color,
+                ha='center', va='center', fontweight='bold')
+        ax.text(7.5, 4, '12 signals', fontsize=18, color='white',
+                ha='center', va='center')
+        ax.text(7.5, 3.3, '<1ms routing', fontsize=14, color='white',
+                ha='center', va='center')
+        
+        # Arrows to providers
+        providers = [('Groq\nFree', 12, 6.5, accent3),
+                    ('GPT-4o\nPremium', 12, 4.5, accent2),
+                    ('Gemini\nMid', 12, 2.5, accent4)]
+        
+        progress = frame_num / total_frames
+        for i, (name, x, y, color) in enumerate(providers):
+            if progress > (i * 0.3):
+                ax.annotate('', xy=(x, y), xytext=(9.5, 4.5),
+                            arrowprops=dict(arrowstyle='->', color=color, lw=2))
+                rect = patches.FancyBboxPatch((x-0.8, y-0.5), 1.6, 1,
+                                               boxstyle="round,pad=0.05",
+                                               facecolor=color, edgecolor='white', 
+                                               linewidth=1, alpha=min(1, (progress - i*0.3)*3))
+                ax.add_patch(rect)
+                ax.text(x, y, name, fontsize=12, color=bg_color,
+                        ha='center', va='center', fontweight='bold', alpha=min(1, (progress - i*0.3)*3))
+                
+    elif scene_num == 3:
+        # Scene 3: 12 signals animation
+        ax.text(8, 8, '12 Keyword Signals', fontsize=44, color=accent1,
+                ha='center', va='center', fontweight='bold')
+        ax.text(8, 7, 'Multi-dimensional query analysis', fontsize=24, color=text_color,
+                ha='center', va='center', alpha=0.7)
+        
+        # Grid of signals
+        signals = ['coding', 'math', 'creative', 'factual', 
+                   'simple', 'complex', 'debug', 'explain',
+                   'short', 'long', 'structured', 'open']
+        
+        progress = frame_num / total_frames
+        cols = 4
+        for idx, sig in enumerate(signals):
+            row = idx // cols
+            col = idx % cols
+            x = 3 + col * 2.5
+            y = 5.5 - row * 1.8
+            
+            alpha = min(1, max(0, (progress - idx * 0.08) * 3))
+            if alpha > 0:
+                color = [accent1, accent3, accent4, accent2][idx % 4]
+                circle = patches.Circle((x, y), 0.5, color=color, alpha=alpha * 0.8)
+                ax.add_patch(circle)
+                ax.text(x, y, sig, fontsize=14, color=bg_color,
+                        ha='center', va='center', fontweight='bold', alpha=alpha)
+                
+    elif scene_num == 4:
+        # Scene 4: Benchmark reveal
+        ax.text(8, 7, 'RouterArena Benchmark', fontsize=44, color=text_color,
+                ha='center', va='center', fontweight='bold')
+        
+        progress = frame_num / total_frames
+        
+        # Score reveal
+        if progress > 0.3:
+            score_alpha = min(1, (progress - 0.3) * 3)
+            ax.text(8, 5, '76.43', fontsize=120, color=accent1,
+                    ha='center', va='center', fontweight='bold', alpha=score_alpha,
+                    family='monospace')
+            ax.text(8, 3, '#1 OF 19 ROUTERS', fontsize=28, color=accent3,
+                    ha='center', va='center', alpha=score_alpha)
+            ax.text(8, 2, 'arXiv:2510.00202', fontsize=18, color=text_color,
+                    ha='center', va='center', alpha=score_alpha * 0.7)
+            
+    elif scene_num == 5:
+        # Scene 5: Cost comparison
+        ax.text(8, 7.5, '213x Cheaper', fontsize=56, color=accent3,
+                ha='center', va='center', fontweight='bold')
+        
+        progress = frame_num / total_frames
+        
+        # GPT-5 cost
+        if progress > 0.2:
+            alpha = min(1, (progress - 0.2) * 3)
+            ax.text(4, 5, '$10.02', fontsize=64, color=accent2,
+                    ha='center', va='center', fontweight='bold', alpha=alpha)
+            ax.text(4, 3.5, 'GPT-5', fontsize=24, color=text_color,
+                    ha='center', va='center', alpha=alpha)
+            
+        # A3M cost
+        if progress > 0.5:
+            alpha = min(1, (progress - 0.5) * 3)
+            ax.text(12, 5, '$0.047', fontsize=64, color=accent3,
+                    ha='center', va='center', fontweight='bold', alpha=alpha)
+            ax.text(12, 3.5, 'A3M', fontsize=24, color=text_color,
+                    ha='center', va='center', alpha=alpha)
+            
+        # VS text
+        if progress > 0.7:
+            alpha = min(1, (progress - 0.7) * 3)
+            ax.text(8, 5, 'vs', fontsize=36, color=text_color,
+                    ha='center', va='center', alpha=alpha * 0.5)
+            ax.text(8, 2, 'Same quality, 1/213th the cost',
+                    fontsize=22, color=text_color, ha='center', va='center', alpha=alpha)
+    
+    plt.tight_layout()
+    plt.savefig(output_path, facecolor=bg_color, dpi=100)
+    plt.close()
+
+def main():
+    if not check_deps():
+        sys.exit(1)
+    
+    print("🎬 A3M Router — 3Blue1Brown Style Video Generator")
+    print("=" * 50)
+    
+    # Create output directory
+    output_dir = '/Users/Subho/adaptive-memory-multi-model-router/demo/frames_3b1b'
+    os.makedirs(output_dir, exist_ok=True)
+    
+    total_scenes = len(SCENES)
+    frames_per_scene = 30  # 30 frames per scene = ~1s at 30fps
+    
+    print(f"Generating {total_scenes} scenes, {frames_per_scene} frames each...")
+    print(f"Output: {output_dir}")
+    
+    for scene in SCENES:
+        scene_id = scene['id']
+        scene_dir = os.path.join(output_dir, f'scene_{scene_id}')
+        os.makedirs(scene_dir, exist_ok=True)
+        
+        print(f"\n📽️ Scene {scene_id}: {scene['title']}")
+        
+        for frame_num in range(1, frames_per_scene + 1):
+            output_path = os.path.join(scene_dir, f'frame_{frame_num:04d}.png')
+            generate_frame_matplotlib(scene_id, frame_num, frames_per_scene, output_path)
+            
+            if frame_num % 10 == 0:
+                print(f"  Frame {frame_num}/{frames_per_scene}")
+    
+    print(f"\n✅ Generated {total_scenes * frames_per_scene} frames")
+    print(f"\nNext steps:")
+    print(f"1. Install ffmpeg: brew install ffmpeg")
+    print(f"2. Run: ./demo/render_3b1b_video.sh")
+    
+    # Save scene config
+    with open(os.path.join(output_dir, 'scenes.json'), 'w') as f:
+        json.dump(SCENES, f, indent=2)
+    
+    print(f"\n3. Or use Python to create video:")
+    print(f"   python3 -c \"from PIL import Image; import subprocess\"")
+    print(f"   # Then run ffmpeg to compile")
+
+if __name__ == '__main__':
+    main()

package/demo/3blue1brown_video_v2.py

@@ -0,0 +1,310 @@
+#!/usr/bin/env python3
+"""
+A3M Router — 3Blue1Brown Style Explainer Video Generator
+Improved version with more frames and better animations
+"""
+
+import subprocess
+import json
+import sys
+import os
+import shutil
+
+def run_command(cmd, cwd=None):
+    result = subprocess.run(cmd, shell=True, capture_output=True, text=True, cwd=cwd)
+    return result.returncode == 0, result.stdout, result.stderr
+
+def check_deps():
+    try:
+        import matplotlib
+        import numpy
+        print("✅ matplotlib, numpy available")
+        return True
+    except ImportError as e:
+        print(f"❌ Missing: {e}")
+        return False
+
+def generate_frame_matplotlib(scene_num, frame_num, total_frames, output_path):
+    """Generate a single frame using matplotlib"""
+    import matplotlib.pyplot as plt
+    import matplotlib.patches as patches
+    import numpy as np
+    
+    # 3Blue1Brown color scheme
+    bg_color = '#1a1a2e'
+    text_color = '#ffffff'
+    accent1 = '#00a8ff'  # Blue
+    accent2 = '#ff6b6b'  # Red  
+    accent3 = '#4ecdc4'  # Teal
+    accent4 = '#ffe66d'  # Yellow
+    accent5 = '#a855f7'  # Purple
+    
+    fig, ax = plt.subplots(figsize=(16, 9), facecolor=bg_color)
+    ax.set_facecolor(bg_color)
+    ax.set_xlim(0, 16)
+    ax.set_ylim(0, 9)
+    ax.axis('off')
+    
+    # Smooth animation progress (ease-in-out)
+    def ease(t):
+        return t * t * (3 - 2 * t)  # Smoothstep
+    
+    progress = ease(frame_num / total_frames)
+    
+    if scene_num == 1:
+        # Scene 1: The problem - expensive AI
+        ax.text(8, 6.5, 'The Problem:', fontsize=36, color=text_color,
+                ha='center', va='center', alpha=0.8)
+        ax.text(8, 5, '$10.02', fontsize=140, color=accent2, 
+                ha='center', va='center', fontweight='bold', family='monospace',
+                alpha=progress)
+        ax.text(8, 2.5, 'per 1,000 queries', fontsize=32, color=text_color,
+                ha='center', va='center', alpha=progress * 0.9)
+        ax.text(8, 1.2, 'GPT-4o premium pricing', fontsize=20, color=text_color,
+                ha='center', va='center', alpha=progress * 0.6, style='italic')
+        
+        # Floating dollar signs
+        for i in range(int(progress * 15)):
+            x = 2 + (i % 5) * 2.8 + np.sin(i * 0.7) * 0.5
+            y = 7.5 - (i // 5) * 2 + np.cos(i * 0.5) * 0.3
+            size = 20 + (i % 3) * 10
+            ax.text(x, y, '$', fontsize=size, color=accent2, alpha=0.4)
+            
+    elif scene_num == 2:
+        # Scene 2: The routing concept
+        ax.text(8, 7.5, 'The Solution:', fontsize=36, color=text_color,
+                ha='center', va='center', alpha=0.8)
+        ax.text(8, 6.2, 'Intelligent LLM Routing', fontsize=48, color=accent1,
+                ha='center', va='center', fontweight='bold', alpha=progress)
+        
+        # Query → Router → Provider flow
+        query_x = 2.5
+        router_x = 8
+        provider_x = 13.5
+        
+        # Query box (animate in)
+        if progress > 0.1:
+            q_alpha = min(1, (progress - 0.1) * 3)
+            rect = patches.FancyBboxPatch((query_x - 1.2, 3.2), 2.4, 2, 
+                                           boxstyle="round,pad=0.15",
+                                           facecolor=accent3, edgecolor='white', 
+                                           linewidth=3, alpha=q_alpha)
+            ax.add_patch(rect)
+            ax.text(query_x, 4.2, 'YOUR', fontsize=20, color=bg_color,
+                    ha='center', va='center', fontweight='bold', alpha=q_alpha)
+            ax.text(query_x, 3.6, 'QUERY', fontsize=20, color=bg_color,
+                    ha='center', va='center', fontweight='bold', alpha=q_alpha)
+        
+        # Router box
+        if progress > 0.3:
+            r_alpha = min(1, (progress - 0.3) * 3)
+            rect = patches.FancyBboxPatch((router_x - 1.8, 2.5), 3.6, 3.4, 
+                                           boxstyle="round,pad=0.15",
+                                           facecolor=accent1, edgecolor='white', 
+                                           linewidth=4, alpha=r_alpha)
+            ax.add_patch(rect)
+            ax.text(router_x, 4.7, 'A3M', fontsize=36, color=text_color,
+                    ha='center', va='center', fontweight='bold', alpha=r_alpha)
+            ax.text(router_x, 3.7, 'ROUTER', fontsize=28, color=text_color,
+                    ha='center', va='center', fontweight='bold', alpha=r_alpha)
+            ax.text(router_x, 2.9, '<1ms • No GPU', fontsize=14, color='white',
+                    ha='center', va='center', alpha=r_alpha * 0.8)
+        
+        # Provider boxes
+        if progress > 0.5:
+            providers = [
+                ('FREE', 'Groq', accent3, 6),
+                ('CHEAP', 'Mistral', accent4, 4.2),
+                ('PREMIUM', 'GPT-4o', accent2, 2.4)
+            ]
+            for name, model, color, y in providers:
+                p_alpha = min(1, (progress - 0.5) * 2)
+                rect = patches.FancyBboxPatch((provider_x - 1.5, y - 0.4), 3, 0.8,
+                                               boxstyle="round,pad=0.1",
+                                               facecolor=color, edgecolor='white',
+                                               linewidth=2, alpha=p_alpha * 0.9)
+                ax.add_patch(rect)
+                ax.text(provider_x, y, f'{name}', fontsize=14, color=bg_color,
+                        ha='center', va='center', fontweight='bold', alpha=p_alpha)
+        
+        # Arrows
+        if progress > 0.2:
+            a_alpha = min(1, (progress - 0.2) * 3)
+            ax.annotate('', xy=(router_x - 1.8, 4.2), xytext=(query_x + 1.2, 4.2),
+                        arrowprops=dict(arrowstyle='->', color=accent1, lw=3), alpha=a_alpha)
+        
+        if progress > 0.5:
+            for y in [6, 4.2, 2.4]:
+                ax.annotate('', xy=(provider_x - 1.5, y), xytext=(router_x + 1.8, 4.2),
+                            arrowprops=dict(arrowstyle='->', color='white', lw=2), alpha=0.5)
+                
+    elif scene_num == 3:
+        # Scene 3: 12 signals
+        ax.text(8, 7.8, '12 Keyword Signals', fontsize=48, color=accent1,
+                ha='center', va='center', fontweight='bold', alpha=progress)
+        ax.text(8, 6.8, 'Instant multi-dimensional query analysis', fontsize=22, 
+                color=text_color, ha='center', va='center', alpha=progress * 0.7)
+        
+        signals = [
+            ('code', accent1), ('math', accent3), ('creative', accent4), 
+            ('factual', accent2), ('simple', accent1), ('complex', accent3),
+            ('debug', accent4), ('explain', accent2), ('short', accent1),
+            ('long', accent3), ('structured', accent4), ('open', accent2)
+        ]
+        
+        cols = 4
+        for idx, (sig, color) in enumerate(signals):
+            row = idx // cols
+            col = idx % cols
+            x = 3.2 + col * 2.7
+            y = 5.2 - row * 1.7
+            
+            # Staggered animation
+            sig_progress = max(0, min(1, (progress - idx * 0.06) * 4))
+            if sig_progress > 0:
+                circle = patches.Circle((x, y), 0.6, color=color, alpha=sig_progress * 0.85)
+                ax.add_patch(circle)
+                ax.text(x, y, sig, fontsize=16, color=bg_color,
+                        ha='center', va='center', fontweight='bold', alpha=sig_progress)
+        
+        # Bottom text
+        if progress > 0.8:
+            ax.text(8, 1, 'Zero ML training • No GPU required • Runs anywhere', 
+                    fontsize=16, color=text_color, ha='center', va='center',
+                    alpha=(progress - 0.8) * 5, style='italic')
+            
+    elif scene_num == 4:
+        # Scene 4: RouterArena results
+        ax.text(8, 7.5, 'Official Benchmark Results', fontsize=40, color=text_color,
+                ha='center', va='center', fontweight='bold', alpha=0.8)
+        ax.text(8, 6.5, 'RouterArena (arXiv:2510.00202)', fontsize=20, color=accent3,
+                ha='center', va='center', alpha=progress * 0.7)
+        
+        # Big score reveal
+        if progress > 0.2:
+            score_alpha = min(1, (progress - 0.2) * 2.5)
+            ax.text(8, 4.5, '76.43', fontsize=140, color=accent1,
+                    ha='center', va='center', fontweight='bold', alpha=score_alpha,
+                    family='monospace')
+            
+        if progress > 0.4:
+            ax.text(8, 2.8, '#1', fontsize=72, color=accent4,
+                    ha='center', va='center', fontweight='bold',
+                    alpha=min(1, (progress - 0.4) * 3))
+            ax.text(8, 2, 'OUT OF 19 ROUTERS', fontsize=24, color=text_color,
+                    ha='center', va='center',
+                    alpha=min(1, (progress - 0.4) * 3))
+            
+        if progress > 0.6:
+            # Comparison bars
+            bars = [
+                ('A3M', 76.43, accent1),
+                ('Sqwish', 75.27, accent3),
+                ('GPT-5', 64.32, accent2),
+            ]
+            bar_y = 0.8
+            for name, score, color in bars:
+                bar_alpha = min(1, (progress - 0.6) * 2)
+                bar_width = (score / 100) * 12
+                rect = patches.FancyBboxPatch((2, bar_y), bar_width, 0.4,
+                                               boxstyle="round,pad=0.05",
+                                               facecolor=color, alpha=bar_alpha * 0.8)
+                ax.add_patch(rect)
+                ax.text(14.5, bar_y + 0.2, f'{name}: {score}', fontsize=14,
+                        color=text_color, ha='right', va='center', alpha=bar_alpha)
+                bar_y += 0.6
+                
+    elif scene_num == 5:
+        # Scene 5: 213x savings
+        ax.text(8, 7.2, '213× Cheaper', fontsize=64, color=accent3,
+                ha='center', va='center', fontweight='bold', alpha=progress)
+        
+        if progress > 0.2:
+            # GPT-5 side
+            gpt_alpha = min(1, (progress - 0.2) * 3)
+            ax.text(4, 5, '$10.02', fontsize=72, color=accent2,
+                    ha='center', va='center', fontweight='bold', alpha=gpt_alpha)
+            ax.text(4, 3.5, 'GPT-5', fontsize=28, color=text_color,
+                    ha='center', va='center', alpha=gpt_alpha)
+            
+        if progress > 0.5:
+            # A3M side
+            a3m_alpha = min(1, (progress - 0.5) * 3)
+            ax.text(12, 5, '$0.047', fontsize=72, color=accent3,
+                    ha='center', va='center', fontweight='bold', alpha=a3m_alpha)
+            ax.text(12, 3.5, 'A3M', fontsize=28, color=text_color,
+                    ha='center', va='center', alpha=a3m_alpha)
+            
+        if progress > 0.7:
+            # VS divider
+            vs_alpha = min(1, (progress - 0.7) * 4)
+            ax.text(8, 5, 'vs', fontsize=48, color=text_color,
+                    ha='center', va='center', alpha=vs_alpha * 0.5)
+            
+        if progress > 0.8:
+            ax.text(8, 2, 'Same quality routing • 1/213th the cost',
+                    fontsize=20, color=text_color, ha='center', va='center',
+                    alpha=(progress - 0.8) * 5, style='italic')
+            
+        if progress > 0.9:
+            ax.text(8, 1, 'github.com/Das-rebel/a3m-router',
+                    fontsize=16, color=accent1, ha='center', va='center',
+                    alpha=(progress - 0.9) * 10)
+    
+    plt.tight_layout()
+    plt.savefig(output_path, facecolor=bg_color, dpi=100)
+    plt.close()
+
+def main():
+    if not check_deps():
+        sys.exit(1)
+    
+    print("🎬 A3M Router — 3Blue1Brown Style Video Generator v2")
+    print("=" * 55)
+    
+    output_dir = '/Users/Subho/adaptive-memory-multi-model-router/demo/frames_3b1b_v2'
+    
+    # Clean old frames
+    if os.path.exists(output_dir):
+        shutil.rmtree(output_dir)
+    os.makedirs(output_dir)
+    
+    scenes = [
+        {"id": 1, "title": "The Problem", "duration": 4.0},
+        {"id": 2, "title": "The Solution", "duration": 5.0},
+        {"id": 3, "title": "12 Signals", "duration": 5.0},
+        {"id": 4, "title": "Benchmark", "duration": 4.0},
+        {"id": 5, "title": "213x Savings", "duration": 4.0},
+    ]
+    
+    fps = 30
+    total_frames = 0
+    
+    for scene in scenes:
+        scene_id = scene['id']
+        scene_dir = os.path.join(output_dir, f'scene_{scene_id}')
+        os.makedirs(scene_dir)
+        
+        num_frames = int(scene['duration'] * fps)
+        total_frames += num_frames
+        
+        print(f"\n📽️ Scene {scene_id}: {scene['title']} ({num_frames} frames)")
+        
+        for frame_num in range(1, num_frames + 1):
+            output_path = os.path.join(scene_dir, f'frame_{frame_num:04d}.png')
+            generate_frame_matplotlib(scene_id, frame_num, num_frames, output_path)
+            
+            if frame_num % 30 == 0:
+                print(f"  ✓ Frame {frame_num}/{num_frames}")
+    
+    print(f"\n✅ Generated {total_frames} total frames ({total_frames/fps:.1f}s)")
+    
+    # Save scene config
+    with open(os.path.join(output_dir, 'config.json'), 'w') as f:
+        json.dump({"scenes": scenes, "fps": fps}, f, indent=2)
+    
+    return output_dir
+
+if __name__ == '__main__':
+    output = main()
+    print(f"\nOutput directory: {output}")

package/demo/IMPROVED_PROMPTS.md

@@ -58,7 +58,7 @@
 1. **HOOK (0-2s):** "I built a router that saves $10,000/month" - SHOCK VALUE
 2. **PROOF (2-5s):** Live demo showing cost comparison - GPT-4 vs A3M
 3. **WOW MOMENT (5-8s):** Show parallel execution, all 5 providers firing
-4. **SOCIAL PROOF (8-10s):** "#1 on RouterArena with 76.43"
+4. **SOCIAL PROOF (8-10s):** "#1 on RouterArena with 70.32"
 5. **CTA (10-12s):** "npm install adaptive-memory-multi-model-router"
 
 ### For HN/PH Audience Specifically:
@@ -131,7 +131,7 @@
 
 ### Frame 4: SOCIAL PROOF (12-15s)
 **Image prompt:**
-> Clean minimalist dark card floating in space, "A3M Router" in bold white text centered, below in gold/amber text: "#1 on RouterArena · 76.43 benchmark score", below that gray text: "40 providers · 213× cheaper than GPT-4", subtle blue glow around text, spotlight from above, Apple keynote aesthetic, dark void background, professional product photography
+> Clean minimalist dark card floating in space, "A3M Router" in bold white text centered, below in gold/amber text: "#1 on RouterArena · 70.32 benchmark score", below that gray text: "40 providers · 213× cheaper than GPT-4", subtle blue glow around text, spotlight from above, Apple keynote aesthetic, dark void background, professional product photography
 
 **Video prompt (JSON):**
 ```json

package/dist/cli/setupWizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizard.d.ts","sourceRoot":"","sources":["../../src/cli/setupWizard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAA,MAAM,EAAE,KAAgB,CAAC;AACzB,QAAA,MAAM,IAAI,KAAkB,CAAC;AAC7B,QAAA,MAAM,QAAQ,KAAsB,CAAC;AAErC,QAAA,MAAM,UAAU,KAAiE,CAAC;AAClF,QAAA,MAAM,WAAW,KAA0C,CAAC;AAG5D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAGF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBlB,CAAC;AAEF,iBAAS,eAAe,QAKvB;AAED,iBAAS,QAAQ,CAAC,EAAE,KAAA,EAAE,IAAI,KAAA,oBAIzB;AAED,iBAAe,aAAa;;;;KAQ3B;AAED,iBAAe,SAAS,kBAkHvB"}

package/dist/cost/budgetEnforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetEnforcer.d.ts","sourceRoot":"","sources":["../../src/cost/budgetEnforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,KAAK,CAAuC;IAGpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAmB;;IAQ7D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACxD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,IAAI;IAsBR;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOlC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB;IA4CtE;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAiD/C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAUjD;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAU5B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWjC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAShB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IA4BvD;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAOtD;AAMD,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAMD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAS1D"}

package/dist/observability/changeWatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeWatch.d.ts","sourceRoot":"","sources":["../../src/observability/changeWatch.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAU,GAAG,MAAM,CAU/E;AAED,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAgBlD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C"}

package/dist/observability/fatigueDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatigueDetector.d.ts","sourceRoot":"","sources":["../../src/observability/fatigueDetector.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CA8BrD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAS5C"}

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAsBjC,cAAM,gBAAgB;IACpB,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAwD;IAC1E,OAAO,CAAC,SAAS,CAAsB;IAEvC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAKxF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK5E;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAkBnF;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAmE9B;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAuCtB,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAKD,wBAAgB,UAAU,IAAI,gBAAgB,CAK7C;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAGzD"}

package/dist/observability/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/observability/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI1D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,IAAI,CAgEN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,GAC1B,IAAI,CAyDN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,IAAI,CAUN"}

package/dist/observability/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/observability/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAsB,MAAM,SAAS,CAAC;AAG/D,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,cAAM,MAAO,SAAQ,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;;IAMxC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAmC1C;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAsB7D;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAmB/D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAoBhF;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAgCpC;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAOvC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE;IAIjC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAKD,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}

package/dist/observability/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CACzC;AAGD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/routing/crossModelValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossModelValidation.d.ts","sourceRoot":"","sources":["../../src/routing/crossModelValidation.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,gBAAgB,CAAC,CA8B3B"}