adaptive-memory-multi-model-router 2.14.46 → 2.14.48

package/docs/launch-content/twitter_thread.txt

@@ -1,460 +0,0 @@
-# Twitter/X Thread
-
-## Thread 1: Cost Savings Focus
-
-Tweet 1/7:
-I built an AI framework that saves 82% on LLM costs.
-
-Here's how:
-
-Most AI frameworks use premium models for everything → Expensive 💸
-
-TMLPD classifies tasks and routes intelligently:
-→ Simple task → Cheap model ($0.20/1M)
-→ Complex task → Premium model ($18/1M)
-
-Result: 82% savings! 🎉
-
-[Image: Cost comparison chart]
-
-Thread 🧵👇
-
----
-
-Tweet 2/7:
-The secret: **Difficulty-Aware Routing** (no other framework has this)
-
-TMLPD classifies tasks into 5 levels using 8 factors:
-- Length (token count)
-- Multi-step reasoning
-- Technical complexity
-- Requirements
-- Dependencies
-- Domain familiarity
-- Nesting complexity
-- Ambiguity
-
-Total score = 0-100
-
----
-
-Tweet 3/7:
-Then routes to optimal provider:
-
-**TRIVIAL** (0-20): "What is 2+2?"
-→ Cerebras @ $0.20/1M tokens
-→ Cost: $0.000001
-
-**SIMPLE** (20-40): "Create React button"
-→ Cerebras/Groq
-→ Cost: $0.001
-
-**MEDIUM** (40-60): "Build REST API"
-→ OpenAI @ $12.50/1M
-→ Cost: $0.01
-
----
-
-Tweet 4/7:
-**COMPLEX** (60-80): "Design microservices architecture"
-→ Anthropic Claude @ $18/1M
-→ Cost: $0.005
-
-**EXPERT** (80-100): "Implement consensus algorithm"
-→ Anthropic Claude
-→ Cost: $0.008
-
-Simple tasks get cheap models. Complex tasks get premium quality.
-
----
-
-Tweet 5/7:
-**Real Benchmark**: 100 Tasks
-
-Traditional (always premium):
-100 tasks × $0.05 avg = $5.00
-
-TMLPD (intelligent routing):
-60 TRIVIAL/SIMPLE → $0.06
-30 MEDIUM → $0.30
-10 COMPLEX/EXPERT → $0.50
-**Total: $0.86**
-
-**Savings: 82.8%** 🎉
-
----
-
-Tweet 6/7:
-But wait, there's more! TMLPD also has:
-
-✅ **3-Tier Memory System** (industry first)
-- Episodic: Specific executions
-- Semantic: Generalized patterns
-- Working: Fast cache (<1ms)
-
-✅ **4 Execution Modes**
-- Direct, Chain, Parallel (2-5x speedup), Orchestrator
-
-✅ **Built by AI** (meta!)
-
----
-
-Tweet 7/7:
-**Open Source** (MIT License)
-
-Get started in 30 seconds:
-
-```bash
-pip install anthropic openai
-export ANTHROPIC_API_KEY="your_key"
-
-python3 << 'EOF'
-from src.tmlpd_agent import TMLPDUnifiedAgent
-
-result = await TMLPDUnifiedAgent().execute({
-    "description": "Build a REST API"
-})
-print(f"Cost: ${result['cost']:.6f}")
-EOF
-```
-
-GitHub: https://github.com/Das-rebel/tmlpd-skill
-
-🤖 Built by AI, for AI, using AI
-
----
-
-## Thread 2: Built by AI Focus
-
-Tweet 1/6:
-TMLPD v2.1 was built by TMLPD v2.0.
-
-Here's the wildest part:
-- 8 parallel AI agents
-- 2,500+ lines of production code
-- 4 major features
-- Completed in 48 hours
-
-The meta story is real. 🤖
-
-Thread 🧵👇
-
----
-
-Tweet 2/6:
-**Agent 1-2**: Difficulty-Aware Routing System
-
-Built the 8-factor classification algorithm:
-- Multi-factor scoring system
-- Historical performance tracking
-- Confidence scoring
-- Learning from past executions
-
-400+ lines, tested and production-ready.
-
----
-
-Tweet 3/6:
-**Agent 3-5**: Advanced Memory System
-
-Implemented 3-tier architecture:
-
-**Episodic Memory** (Agent 3):
-- JSON-based storage
-- Importance-based retention
-- Instant recall (10-50ms)
-
-**Semantic Memory** (Agent 4):
-- ChromaDB vector patterns
-- Pattern extraction
-- Cross-task learning
-
-**Working Memory** (Agent 5):
-- LRU cache
-- TTL expiration
-- <1ms lookups
-
----
-
-Tweet 4/6:
-**Agent 6-8**: Workflow Executors
-
-**Chaining** (Agent 6):
-- Sequential execution
-- Context passing
-- Conditional branching
-
-**Parallelization** (Agent 7):
-- Concurrent tasks
-- Dependency resolution
-- 2-5x speedup
-
-**Orchestrator** (Agent 8):
-- Auto-decomposition
-- Intelligent delegation
-- Adaptive strategy selection
-
----
-
-Tweet 5/6:
-**The Unified Agent** (Agent coordination):
-
-Combined all phases into a single, production-ready API:
-
-```python
-async with TMLPDUnifiedAgent() as agent:
-    result = await agent.execute({
-        "description": "Build complete e-commerce platform"
-    })
-
-    # Automatically:
-    # 1. Recalls from memory
-    # 2. Classifies difficulty
-    # 3. Decomposes into sub-tasks
-    # 4. Routes to optimal providers
-    # 5. Executes in parallel
-    # 6. Stores in memory
-```
-
----
-
-Tweet 6/6:
-**Why This Matters**:
-
-1. **Self-Improving**: Each version gets better
-2. **Parallel Execution**: AI agents working together
-3. **Production Quality**: Not a demo, real code
-4. **Open Source**: MIT license, learn from it
-
-GitHub: https://github.com/Das-rebel/tmlpd-skill
-
-Full Docs: https://github.com/Das-rebel/tmlpd-skill/blob/main/docs/TMLPD_V2.1_COMPLETE.md
-
-The future of AI development is AI-driven. 🚀
-
----
-
-## Thread 3: 3-Tier Memory Focus
-
-Tweet 1/7:
-Most AI agent frameworks have ZERO memory.
-
-LangChain? No memory.
-AutoGPT? No memory.
-CrewAI? No memory.
-
-You have to roll your own. ❌
-
-TMLPD has a 3-tier memory system. Here's why it matters: 🧵👇
-
----
-
-Tweet 2/7:
-**The Problem**:
-
-Current agents are stateless. They don't:
-- Remember past executions
-- Learn from experience
-- Recognize patterns
-- Transfer knowledge across tasks
-
-Every task is like starting from scratch. Inefficient and expensive. 💸
-
----
-
-Tweet 3/7:
-**The Solution**: 3-Tier Memory (inspired by human cognition)
-
-**Tier 1: Episodic Memory** (Specific)
-- Stores full context from task executions
-- "On Jan 15, I built a REST API in 20 minutes using OpenAI"
-- Instant recall: 10-50ms
-- JSON-based, no external dependencies
-
----
-
-Tweet 4/7:
-**Tier 2: Semantic Memory** (Generalized)
-
-This is the magic. It extracts PATTERNS:
-
-Episodic: "Built REST API with JWT"
-Episodic: "Built GraphQL API with OAuth"
-Episodic: "Built gRPC API with Tokens"
-
-Semantic Pattern: "API authentication = {JWT, OAuth, Tokens}"
-
-Next time: "Build WebSocket API" → recalls authentication patterns
-
----
-
-Tweet 5/7:
-**Tier 3: Working Memory** (Fast Cache)
-
-Active session context:
-- Recent computations
-- Intermediate results
-- Frequently accessed data
-
-Performance:
-- <1ms lookups
-- 80-95% hit rate
-- LRU eviction + TTL expiration
-
-Like RAM for AI agents. ⚡
-
----
-
-Tweet 6/7:
-**Research Foundation**:
-
-Built on 30+ arXiv papers (2024-2025):
-
-📄 arXiv:2512.12686 - Memoria Framework (50% coherence improvement)
-📄 arXiv:2502.12110 - A-Mem (144+ citations)
-📄 arXiv:2410.10601 - RefAct (reasoning-action)
-📄 arXiv:2406.04722 - CAMEL (communicative agents)
-
-This isn't magic. It's science. 🔬
-
----
-
-Tweet 7/7:
-**The Result**:
-
-✅ Agents that learn from experience
-✅ Pattern recognition across tasks
-✅ 40-60% cost reduction (fewer repeated API calls)
-✅ 2-5x speedup (cache hits)
-
-Open Source (MIT):
-
-GitHub: https://github.com/Das-rebel/tmlpd-skill
-
-Stop building stateless agents. Start building agents that learn. 🧠✨
-
----
-
-## Thread 4: Quick Comparison / Alternatives
-
-Tweet 1/5:
-Thinking about using LangChain, AutoGPT, or CrewAI?
-
-Here's a quick comparison with TMLPD v2.1:
-
-Cost savings: 82%
-Memory system: 3-tier
-Parallel execution: Auto (2-5x)
-
-Details 👇
-
----
-
-Tweet 2/5:
-**LangChain**:
-❌ No difficulty classification (uses same model for everything)
-❌ No built-in memory
-❌ Manual parallel execution
-✅ Good abstraction layer
-
-**TMLPD**:
-✅ 8-factor difficulty classification
-✅ 3-tier memory (episodic, semantic, working)
-✅ Auto parallel execution (2-5x speedup)
-✅ 82% cost savings
-
----
-
-Tweet 3/5:
-**AutoGPT**:
-❌ No difficulty classification
-⚠️ Basic memory (not production-ready)
-⚠️ Manual parallel execution
-✅ Autonomous task execution
-
-**TMLPD**:
-✅ Intelligent difficulty routing
-✅ Production 3-tier memory
-✅ Auto parallel + orchestration
-✅ Research-backed (30+ papers)
-
----
-
-Tweet 4/5:
-**CrewAI**:
-❌ No difficulty classification
-⚠️ Basic memory
-⚠️ Manual parallel execution
-✅ Role-based agent teams
-
-**TMLPD**:
-✅ Auto difficulty scoring + routing
-✅ Advanced 3-tier memory
-✅ Auto parallel + chain + orchestration
-✅ Multi-provider (5 providers)
-
----
-
-Tweet 5/5:
-**Bottom Line**:
-
-If you want:
-- Save money on LLM costs → TMLPD (82% savings)
-- Memory that learns → TMLPD (3-tier system)
-- Auto parallel execution → TMLPD (2-5x speedup)
-- Role-based agents → CrewAI
-- Simple abstraction → LangChain
-
-Try TMLPD: https://github.com/Das-rebel/tmlpd-skill
-
-MIT License. Production-ready. 🚀
-
----
-
-## Posting Strategy
-
-### Timing
-- **Best**: 8-11 AM EST (Tuesday-Thursday)
-- **Good**: 12-2 PM EST (lunch engagement)
-- **Avoid**: Friday evening, weekends (low engagement)
-
-### Frequency
-- **Day 1**: Thread 1 (Cost savings) - High impact, numbers-driven
-- **Day 2**: Thread 2 (Built by AI) - Viral meta-story
-- **Day 4**: Thread 3 (Memory system) - Technical depth
-- **Day 6**: Thread 4 (Comparison) - SEO for competitor keywords
-
-### Engagement
-- Reply to every comment within 15 minutes
-- Ask questions to encourage discussion
-- Share user success stories
-- Post metrics updates ("48 hours: 200 stars, 100+ users")
-
-### Visuals
-- **Cost comparison chart** (Thread 1)
-- **Architecture diagram** (Thread 2)
-- **Memory system diagram** (Thread 3)
-- **Feature comparison table** (Thread 4)
-- **GIFs** of terminal execution
-
-### Hashtags
-#AI #MachineLearning #LLM #Claude #GPT4 #OpenSource #Python #DeveloperTools #ArtificialIntelligence #CostOptimization
-
-### Tagging Strategy
-- **Tag influencers**: @AndrewYNg @ylecun @goodfellow_ian @hardmaru
-- **Tag companies**: @AnthropicAI @OpenAI @LangChainAI
-- **Tag platforms**: @github @ThePrDev
-- **Don't over-tag**: 2-3 accounts per thread max
-
-### Success Metrics
-- 1K+ likes per thread
-- 100+ retweets per thread
-- 50+ comments per thread
-- Drive traffic to GitHub (unique visitors)
-- Trending in #AI or #MachineLearning
-
-### Follow-Up Posts (Between Threads)
-- "24 hours since launch: 120 stars, 50+ users saving money!"
-- "User testimonial: 'Saved $45 in my first hour using TMLPD'"
-- "Just merged PR #12: Enhanced ChromaDB integration (thanks @user!)"
-- "New blog post: 'How to Save 80% on LLM Costs with Difficulty Routing'"

package/docs/npm-downloads-chart.svg

@@ -1,43 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="800" height="300" viewBox="0 0 800 300">
-  <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#1a1a2e"/>
-      <stop offset="100%" stop-color="#16213e"/>
-    </linearGradient>
-    <linearGradient id="lineGrad" x1="0" y1="0" x2="1" y2="0">
-      <stop offset="0%" stop-color="#4fc3f7"/>
-      <stop offset="100%" stop-color="#00e676"/>
-    </linearGradient>
-    <linearGradient id="areaGrad" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#4fc3f7" stop-opacity="0.3"/>
-      <stop offset="100%" stop-color="#4fc3f7" stop-opacity="0.02"/>
-    </linearGradient>
-  </defs>
-
-  <rect width="800" height="300" fill="url(#bg)" rx="12"/>
-
-  <text x="400.0" y="30" text-anchor="middle" fill="#e0e0e0" font-family="monospace" font-size="16" font-weight="bold">npm Downloads</text>
-  <text x="400.0" y="50" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="11">Total: 11,637 · v2.13.24 · 🥇 RouterArena #1 (76.43) · Cheapest at $0.047/1K</text>
-  <line x1="60" y1="60.0" x2="740" y2="60.0" stroke="#2a2a4e" stroke-width="1"/>
-  <text x="52" y="64.0" text-anchor="end" fill="#90a4ae" font-family="monospace" font-size="10">11,637</text>
-  <line x1="60" y1="105.0" x2="740" y2="105.0" stroke="#2a2a4e" stroke-width="1"/>
-  <text x="52" y="109.0" text-anchor="end" fill="#90a4ae" font-family="monospace" font-size="10">8,727</text>
-  <line x1="60" y1="150.0" x2="740" y2="150.0" stroke="#2a2a4e" stroke-width="1"/>
-  <text x="52" y="154.0" text-anchor="end" fill="#90a4ae" font-family="monospace" font-size="10">5,818</text>
-  <line x1="60" y1="195.0" x2="740" y2="195.0" stroke="#2a2a4e" stroke-width="1"/>
-  <text x="52" y="199.0" text-anchor="end" fill="#90a4ae" font-family="monospace" font-size="10">2,909</text>
-  <line x1="60" y1="240.0" x2="740" y2="240.0" stroke="#2a2a4e" stroke-width="1"/>
-  <text x="52" y="244.0" text-anchor="end" fill="#90a4ae" font-family="monospace" font-size="10">0</text>
-  <text x="60.0" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-13</text>
-  <text x="157.14285714285714" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-15</text>
-  <text x="254.28571428571428" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-17</text>
-  <text x="351.4285714285714" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-19</text>
-  <text x="448.57142857142856" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-21</text>
-  <text x="545.7142857142858" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-23</text>
-  <text x="642.8571428571428" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-25</text>
-  <text x="740.0" y="258" text-anchor="middle" fill="#90a4ae" font-family="monospace" font-size="9">05-27</text>
-  <polygon points="60,240 60.0,240.0 108.6,240.0 157.1,231.5 205.7,226.5 254.3,197.1 302.9,174.7 351.4,168.0 400.0,165.2 448.6,145.6 497.1,114.9 545.7,112.2 594.3,109.0 642.9,100.9 691.4,84.9 740.0,60.0 740.0,240" fill="url(#areaGrad)"/>
-  <polyline points="60.0,240.0 108.6,240.0 157.1,231.5 205.7,226.5 254.3,197.1 302.9,174.7 351.4,168.0 400.0,165.2 448.6,145.6 497.1,114.9 545.7,112.2 594.3,109.0 642.9,100.9 691.4,84.9 740.0,60.0" fill="none" stroke="url(#lineGrad)" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
-  <circle cx="740.0" cy="60.0" r="4" fill="#00e676"/>
-  <text x="748.0" y="64.0" fill="#00e676" font-family="monospace" font-size="11" font-weight="bold">11,637 total</text>
-</svg>

package/docs/openapi.json

@@ -1,139 +0,0 @@
-{
-  "openapi": "3.1.0",
-  "info": {
-    "title": "A3M Router API",
-    "description": "OpenAI-compatible LLM routing proxy with intelligent query classification. Routes queries to the cheapest capable model using multi-signal scoring — 70.32 ±1 tier accuracy on RouterArena (arXiv:2510.00202), $0.047 per 1K queries, no ML required.",
-    "version": "2.2.0",
-    "contact": {
-      "name": "A3M Router",
-      "url": "https://github.com/Das-rebel/a3m-router"
-    },
-    "license": {
-      "name": "MIT",
-      "url": "https://opensource.org/licenses/MIT"
-    }
-  },
-  "servers": [
-    {
-      "url": "http://localhost:8787",
-      "description": "Local proxy server"
-    }
-  ],
-  "paths": {
-    "/v1/route": {
-      "post": {
-        "summary": "Route a query",
-        "description": "Analyze a query and return the optimal model, tier, cost estimate, and complexity score without executing the query.",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "required": ["query"],
-                "properties": {
-                  "query": {
-                    "type": "string",
-                    "description": "The query to route",
-                    "example": "Write a Python function to sort an array"
-                  }
-                }
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "Routing decision",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "model": { "type": "string", "example": "groq/llama-3.3-70b" },
-                    "tier": { "type": "string", "enum": ["free", "cheap", "mid", "premium"], "example": "cheap" },
-                    "cost": { "type": "number", "example": 0.0004 },
-                    "complexity": { "type": "number", "example": 0.33 },
-                    "reasoning": { "type": "string", "example": "Coding task detected" },
-                    "fallback_models": { "type": "array", "items": { "type": "string" } }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/chat/completions": {
-      "post": {
-        "summary": "Chat completion (OpenAI-compatible)",
-        "description": "OpenAI-compatible chat completions endpoint. Set model='auto' for intelligent routing.",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "required": ["messages"],
-                "properties": {
-                  "model": { "type": "string", "default": "auto" },
-                  "messages": {
-                    "type": "array",
-                    "items": {
-                      "type": "object",
-                      "properties": {
-                        "role": { "type": "string" },
-                        "content": { "type": "string" }
-                      }
-                    }
-                  },
-                  "max_tokens": { "type": "integer", "default": 100 },
-                  "temperature": { "type": "number", "default": 0.7 },
-                  "stream": { "type": "boolean", "default": false }
-                }
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OpenAI-compatible chat completion response"
-          }
-        }
-      }
-    },
-    "/v1/models": {
-      "get": {
-        "summary": "List available models",
-        "description": "Returns all available models across 40 LLM providers organized by cost tier.",
-        "responses": {
-          "200": {
-            "description": "Model list"
-          }
-        }
-      }
-    },
-    "/health": {
-      "get": {
-        "summary": "Health check",
-        "description": "Returns health status and provider availability.",
-        "responses": {
-          "200": {
-            "description": "Health status"
-          }
-        }
-      }
-    },
-    "/dashboard": {
-      "get": {
-        "summary": "Cost analytics",
-        "description": "Returns cost analytics, savings report, and per-provider usage.",
-        "responses": {
-          "200": {
-            "description": "Cost analytics report"
-          }
-        }
-      }
-    }
-  }
-}