adaptive-memory-multi-model-router 2.1.1 → 2.2.1

package/llms.txt

@@ -1,85 +1,51 @@
 # A3M Router
-> LLM router with 82.5% routing accuracy without ML — matches RouteLLM BERT within 2.5%. 30x more efficient than GPU-based routing. Drop-in OpenAI proxy, 39 providers.
+> Intelligent LLM routing with adaptive memory — 99.5% ±1 tier accuracy, zero ML, zero GPU. OpenAI-compatible proxy across 36 providers with semantic cache, guardrails, and cost analytics.
 
-## Benchmark Results
-- **82.5% adjacent routing accuracy** without ML or GPU
-- Matches RouteLLM BERT within **2.5 percentage points** (85% vs 82.5%)
-- **30x more efficient** than GPU-based routing (no model weights, no training, no GPU)
-- Only router besides RouteLLM with **published benchmarks**
-- 200-query MMLU-based benchmark with 4-tier routing (free/cheap/mid/premium)
+## Three Core Capabilities
+1. **Adaptive Memory** — Learns from usage patterns. Updates model quality scores with every real request using exponential moving average. No retraining needed.
+2. **Multi-Signal Routing** — 5-signal complexity scoring: domain detection (legal, medical, finance, security, architecture, ML), task indicators (code, math, creative, multilingual), query structure, action verb intensity, multi-step detection. All regex + keyword, zero ML.
+3. **Production Protections** — Semantic cache (trigram Jaccard similarity), 17-pattern prompt injection detection, PII redaction, content filtering, hallucination checks, cost analytics with budget alerts, circuit breaker with auto-failover.
 
-## Growth & Adoption
-- **2,775 downloads in 3 days**
-- **245% growth**, zero marketing budget
-- 39 providers (OpenAI, Anthropic, Groq, Cerebras, DeepSeek, Mistral, Ollama, etc.)
-
-## What
-A3M Router is an OpenAI-compatible proxy that analyzes each query and routes it to the cheapest capable LLM provider. Keyword-based routing achieves near-ML accuracy at a fraction of the cost. Zero config. Zero GPU.
+## Benchmark
+- 64.5% exact tier match, 99.5% ±1 tier accuracy (200 queries, 4 tiers)
+- 61.6% cost savings vs premium-only routing
+- RouteLLM-inspired methodology, self-benchmarked
 
 ## Install
 ```bash
-npm install adaptive-memory-multi-model-router
-npx a3m-router serve
+npm install adaptive-memory-multi-model-router   # TypeScript/Node
+pip install a3m-router                            # Python
+npx a3m-router serve                              # Proxy at localhost:8787
 ```
 
-## Key Metrics
-| Metric | Value |
-|--------|-------|
-| Routing accuracy (adjacent) | 82.5% |
-| Gap to RouteLLM BERT | 2.5% |
-| Efficiency vs GPU routing | 30x |
-| Cost savings vs premium-only | 50-80% |
-| Providers | 39 |
-| Downloads (3 days) | 2,775 |
+## Interfaces
+- **TypeScript SDK:** `import { A3MRouter } from 'adaptive-memory-multi-model-router/sdk'`
+- **Python SDK:** `from a3m import A3MRouter` (async) or `from a3m import A3MRouterSync`
+- **CLI:** `npx a3m-router route/serve/benchmark/health/cost/compare`
+- **Proxy:** OpenAI-compatible at `localhost:8787/v1`
+- **REST API:** POST /v1/route, POST /v1/chat/completions, GET /v1/models, GET /health
+- **LangChain:** `import { A3MChatModel } from 'adaptive-memory-multi-model-router/langchain'`
+
+## 36 Providers by Tier
+- **Free (6):** CommandCode, Ollama, LM Studio, vLLM, OpenCode, Google (free tier)
+- **Cheap (15):** Groq, Cerebras, DeepInfra, Together, Fireworks, Novita, SambaNova, Anyscale, Replicate, OpenRouter, Zhipu (GLM), Moonshot (Kimi), Yi, Baichuan, MiniMax
+- **Mid (9):** DeepSeek, Mistral, Perplexity, Cohere, AI21, Qwen, StepFun, AlephAlpha, Deepset
+- **Premium (3):** OpenAI, Anthropic, xAI (Grok)
+- **Enterprise (3):** Azure OpenAI, AWS Bedrock, Google Vertex
 
 ## Features
-- OpenAI-compatible proxy (drop-in for any SDK)
-- Keyword-based routing with near-ML accuracy
-- Semantic cache (trigram Jaccard similarity)
-- Security guardrails (PII, prompt injection, content filter)
-- Real-time cost analytics dashboard
-- LangChain adapter (A3MChatModel)
-- Circuit breaker with automatic fallback
-- Batch processing with rate limiting
-- 39 providers from free to premium
-
-## Providers by Cost
-- FREE: CommandCode, Ollama, LM Studio, vLLM
-- $0.59-0.60/1M tokens: Groq, Cerebras
-- $1.50-2.80/1M tokens: DeepSeek, MiniMax, Mistral, Qwen, GLM-4
-- $10-30/1M tokens: Google, Anthropic, OpenAI
-
-## API
-```javascript
-const { createA3MRouter } = require('adaptive-memory-multi-model-router');
-const router = createA3MRouter();
-const result = await router.route("Your query");
-console.log(result.primary_model); // "groq/llama-3.3-70b"
-```
-
-## CLI
-```bash
-npx a3m-router serve          # Start OpenAI-compatible proxy on :8787
-npx a3m-router route "query"  # Route a single query
-npx a3m-router benchmark      # Benchmark all providers
-npx a3m-router providers      # List configured providers
-npx a3m-router status         # Show router status
-```
-
-## Use Cases
-- Reduce OpenAI API costs by 50-80%
-- LLM routing without GPU
-- Drop-in OpenAI proxy with cost optimization
-- Route between local (Ollama) and cloud models
-- Build multi-provider AI applications
-- Add guardrails and caching to existing LLM setups
-
-## Competitive Positioning
-- vs RouteLLM: Matches accuracy within 2.5%, no GPU needed, includes proxy+cache+guardrails
-- vs LiteLLM: Published benchmarks, zero-config, built-in semantic cache
-- vs OpenRouter: Self-hosted, no middleman fees, open source
+- Multi-signal routing with 5 weighted signals (domain, task, structure, verbs, specificity)
+- Online learning via exponential moving average on model quality scores
+- Semantic cache using character trigram Jaccard similarity (no vector DB, no embeddings)
+- Guardrails: 17-pattern injection detection, PII detection/redaction (email, phone, SSN, CC, API keys, IP), content filtering, hallucination heuristics
+- Cost analytics: per-provider spend tracking, budget alerts (daily/monthly/per-model), savings vs GPT-4o baseline
+- Circuit breaker: 3 failures → 60s cooldown, automatic provider failover
+- OpenAI-compatible proxy auto-detects provider format (OpenAI, Anthropic, Google, Ollama)
+- LangChain adapter (A3MChatModel drop-in for ChatOpenAI)
+- Streaming support (SSE relay)
+- Obsidian vault integration for decision logging
 
 ## Links
 - GitHub: https://github.com/Das-rebel/adaptive-memory-multi-model-router
-- NPM: https://www.npmjs.com/package/adaptive-memory-multi-model-router
+- npm: https://www.npmjs.org/package/adaptive-memory-multi-model-router
 - License: MIT

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "adaptive-memory-multi-model-router",
-  "version": "2.1.1",
+  "version": "2.2.1",
   "shortName": "A3M Router",
   "displayName": "A3M Router - Adaptive Memory Multi-Model Router",
-  "description": "99.5% ±1 tier routing accuracy, zero ML. Exceeds RouteLLM BERT. Drop-in OpenAI proxy, 40 providers, domain-aware. 245% growth in 3 days.",
+  "description": "LLM router & AI gateway — 4,200+ npm downloads, 99.5% ±1 tier routing accuracy. Multi-signal classification (domain, complexity, verbs), 36 providers, semantic cache, guardrails, cost analytics. TypeScript SDK + Python SDK + CLI + REST API + OpenAI proxy.",
   "main": "dist/index.js",
   "bin": {
     "a3m-router": "dist/cli.js",
@@ -53,35 +53,71 @@
     }
   },
   "keywords": [
-    "llm-router",
-    "llm-routing",
-    "llm-gateway",
-    "openai-proxy",
-    "cost-optimization",
+    "ai",
+    "ai-agent",
+    "ai-cost-optimization",
     "ai-gateway",
-    "routellm-alternative",
-    "litellm-alternative",
-    "portkey-alternative",
-    "semantic-cache",
-    "guardrails",
-    "multi-provider",
-    "openai-compatible",
-    "llm-proxy",
-    "llm-orchestration",
-    "groq",
-    "cerebras",
-    "mistral",
-    "deepseek",
+    "ai-guardrails",
+    "ai-load-balancer",
+    "ai-proxy",
+    "ai-router",
+    "ai-sdk",
     "anthropic",
+    "anthropic-proxy",
     "benchmark",
-    "routing-accuracy",
-    "lightweight",
-    "no-gpu",
+    "cerebras",
+    "cerebras-proxy",
+    "chatbot",
+    "chatgpt",
+    "claude",
+    "claude-proxy",
+    "cost-optimization",
+    "deepseek",
+    "deepseek-proxy",
+    "domain-routing",
+    "gpt",
+    "groq",
+    "groq-proxy",
+    "guardrails",
+    "helicone",
     "keyword-routing",
-    "ai",
+    "langchain",
+    "language-model",
+    "lightweight",
+    "litellm-alternative",
     "llm",
+    "llm-gateway",
+    "llm-load-balancer",
+    "llm-manager",
+    "llm-orchestration",
+    "llm-proxy",
+    "llm-router",
+    "llm-routing",
+    "mistral",
+    "mistral-proxy",
+    "model-router",
+    "model-routing",
+    "multi-llm",
+    "multi-provider",
     "nlp",
-    "language-model"
+    "no-gpu",
+    "ollama",
+    "ollama-proxy",
+    "openai",
+    "openai-api",
+    "openai-compatible",
+    "openai-proxy",
+    "openai-sdk",
+    "openrouter",
+    "portkey-alternative",
+    "provider-fallback",
+    "query-routing",
+    "routellm-alternative",
+    "routing-accuracy",
+    "semantic-cache",
+    "smart-routing",
+    "token-counter",
+    "vercel-ai"
   ],
   "author": "Das-rebel <subho@example.com>",
   "license": "MIT",
@@ -116,5 +152,12 @@
   "devDependencies": {
     "@types/node": "^25.8.0",
     "typescript": "^6.0.3"
-  }
-}
+  },
+  "changelog": [
+    {
+      "version": "2.2.1",
+      "date": "2026-05-19",
+      "note": "4,200+ downloads milestone. Updated description with download count."
+    }
+  ]
+}