adaptive-memory-multi-model-router 2.15.4 → 2.15.5

package/README.md

@@ -28,8 +28,6 @@ response = client.chat.completions.create(
 )  # Routes to Groq/Mistral — costs: $0.0001
 ```
 
-**Result:** Simple questions cost 300x less. Complex queries still go to premium models when needed.
-
 ---
 
 ## Why A3M Router?
@@ -43,6 +41,23 @@ response = client.chat.completions.create(
 
 ---
 
+## Framework Adapters
+
+A3M Router has drop-in adapters for **8 major frameworks**:
+
+| Framework | Adapter | Example |
+|-----------|---------|---------|
+| **LangChain** | `A3MLangChainAdapter` | `pip install adapters/langchain` |
+| **LlamaIndex** | `A3MLlamaIndexAdapter` | `pip install adapters/llamaindex` |
+| **AutoGen** | `A3MAutoGenAdapter` | Multi-agent conversations |
+| **Vercel AI SDK** | `A3MVercelAdapter` | Next.js apps |
+| **Haystack** | `A3MHaystackAdapter` | RAG pipelines |
+| **Pinecone** | `A3MPineconeAdapter` | Vector search + RAG |
+| **LangGraph** | `A3MLangGraphAdapter` | Stateful agents |
+| **CrewAI** | `A3MCompletion` | Multi-agent systems |
+
+---
+
 ## Quick Start
 
 ```bash
@@ -53,138 +68,161 @@ npm install adaptive-memory-multi-model-router
 npx a3m-router serve
 ```
 
-Then use it like any OpenAI-compatible API:
+---
 
-```python
-from openai import OpenAI
+## Installation
 
-client = OpenAI(base_url="http://localhost:8787/v1", api_key="not-needed")
+### Python Adapters
+```bash
+pip install adapters/
+```
 
-# Simple query → routes to cheapest capable (Groq, Mistral, etc.)
-response = client.chat.completions.create(
-    model="auto",
-    messages=[{"role": "user", "content": "What is Python?"}]
-)
+### Docker
+```bash
+docker-compose up -d
+```
+
+### npm
+```bash
+npm install adaptive-memory-multi-model-router
 ```
 
 ---
 
-## Parallel Ensemble — Best Answer, Any Provider
+## Framework Examples
 
-Need the best answer regardless of cost? Call multiple providers in parallel:
+### LangChain
+```python
+from a3m_adapter import A3MLangChainAdapter
+
+llm = A3MLangChainAdapter(model="auto", temperature=0.7)
+result = llm.invoke("What is retrieval-augmented generation?")
+```
 
+### LlamaIndex
 ```python
-from a3m.router import A3MRouter
+from a3m_adapter import A3MLlamaIndexAdapter
 
-router = A3MRouter(
-    model="auto",
-    parallel_ensemble=3,  # ← Call 3 providers simultaneously
-)
+llm = A3MLlamaIndexAdapter(model="auto")
+response = llm.complete("Explain transformer architecture")
+```
 
-result = router.route(
-    messages=[{"role": "user", "content": "Explain quantum entanglement"}],
-    ensemble_timeout_ms=10000,
-)
+### AutoGen (Microsoft)
+```python
+from a3m_adapter import A3MAutoGenAdapter
 
-# result.content     — winning response
-# result.provider    — which provider won
-# result.scores     — quality scores per provider
-# result.all_results — all responses for comparison
+llm = A3MAutoGenAdapter(model="auto", parallel_ensemble=2)
+
+config = llm.create_agent_config()
+assistant = ConversableAgent(name="assistant", llm_config=config)
 ```
 
-**Real-world example:**
+### Vercel AI SDK
 ```python
-# Call Groq (fast/cheap) + OpenAI (quality) + DeepSeek (cost-effective) in parallel
-ensemble_result = router.route(
-    messages=[{"role": "user", "content": prompt}],
-    ensemble_config={
-        "providers": ["groq", "openai", "deepseek"],
-        "timeout_ms": 15000,
-        "score_weights": {"relevance": 0.4, "conciseness": 0.3, "accuracy": 0.3}
-    }
-)
+from a3m_adapter import A3MVercelAdapter, createA3MProvider
 
-print(f"Best answer from: {ensemble_result.provider}")
-print(f"Response: {ensemble_result.content}")
-print(f"All scores: {ensemble_result.scores}")
+result = await generateText({
+    model: createA3MProvider({"model": "auto", "parallel_ensemble": 2}),
+    prompt: "What is 2+2?",
+})
 ```
 
----
+### Haystack (RAG)
+```python
+from a3m_adapter import A3MHaystackAdapter
 
-## Multi-Agent Systems — CrewAI Example
+adapter = A3MHaystackAdapter(model="auto")
+result = adapter.predict(query="What is AI?", documents=retrieved_docs)
+```
 
-Powerful for multi-agent systems where different agents need different model capabilities:
+### Pinecone (Vector Search)
+```python
+from a3m_adapter import A3MPineconeAdapter
+
+adapter = A3MPineconeAdapter(model="auto")
+embedding = adapter.embed_query("What is quantum computing?")
+
+results = index.query(vector=embedding, top_k=5)
+```
+
+### LangGraph (Stateful Agents)
+```python
+from a3m_adapter import A3MLangGraphAdapter
+
+adapter = A3MLangGraphAdapter(model="auto", parallel_ensemble=2)
+agent = create_react_agent(adapter, tools=[...])
+
+result = agent.invoke({"messages": [{"role": "user", "content": "Hello"}]})
+```
 
+### CrewAI (Multi-Agent)
 ```python
-from crewai import Agent, Task, Crew
 from crewai.llms import A3MCompletion
 
-# Research agent — needs factual accuracy
 researcher = Agent(
-    role="Research Analyst",
+    role="Researcher",
     goal="Find accurate information",
-    backstory="Expert researcher",
-    llm=A3MCompletion(model="auto", temperature=0.3),
+    llm=A3MCompletion(model="auto"),
 )
 
-# Writer agent — needs creativity
-writer = Agent(
-    role="Content Writer", 
-    goal="Create engaging content",
-    backstory="Creative writer",
-    llm=A3MCompletion(model="auto", temperature=0.9),
-)
+crew = Crew(agents=[researcher], tasks=[task])
+result = crew.kickoff()
+```
 
-# Critic agent — needs balance
-critic = Agent(
-    role="Quality Critic",
-    goal="Ensure quality", 
-    backstory="Detail editor",
-    llm=A3MCompletion(model="auto", temperature=0.5),
-)
+---
+
+## Parallel Ensemble — Best Answer, Any Provider
 
-# Tasks with expected outputs
-research_task = Task(
-    description="Research AI trends",
-    expected_output="Detailed report with citations",
-    agent=researcher,
+Need the best answer regardless of cost? Call multiple providers in parallel:
+
+```python
+from a3m.router import A3MRouter
+
+router = A3MRouter(
+    model="auto",
+    parallel_ensemble=3,  # ← Call 3 providers simultaneously
 )
 
-crew = Crew(
-    agents=[researcher, writer, critic],
-    tasks=[research_task],
-    process="hierarchical",
-    manager_llm=A3MCompletion(model="auto"),
+result = router.route(
+    messages=[{"role": "user", "content": "Explain quantum entanglement"}],
+    ensemble_config={
+        "providers": ["groq", "openai", "deepseek"],
+        "timeout_ms": 15000,
+        "score_weights": {"relevance": 0.4, "conciseness": 0.3, "accuracy": 0.3}
+    }
 )
 
-result = crew.kickoff()
+print(f"Best answer from: {result.provider}")
+print(f"Response: {result.content}")
+print(f"All scores: {result.scores}")
 ```
 
 ---
 
-## LangChain + LlamaIndex Adapters
+## Memory & Context
 
-Use A3M Router as a drop-in replacement:
+A3M Router includes **semantic memory** capabilities:
 
 ```python
-# LangChain
-from a3m_adapter import A3MLangChainAdapter
-
-llm = A3MLangChainAdapter(
+router = A3MRouter(
     model="auto",
-    temperature=0.7,
-    parallel_ensemble=2
+    memory={
+        "type": "semantic",
+        "window": 10,
+        "similarity_threshold": 0.85,
+    }
 )
 
-# Works with any LangChain chain
-from langchain import chain
-result = llm.invoke("What is retrieval-augmented generation?")
-
-# LlamaIndex
-from a3m_adapter import A3MLlamaIndexAdapter
+# First call — caches context
+result1 = router.route(
+    messages=[{"role": "user", "content": "I'm building a Python web app"}]
+)
 
-llm = A3MLlamaIndexAdapter(model="auto")
-response = llm.complete("Explain transformer architecture")
+# Second call — uses cached context
+result2 = router.route(
+    messages=[{"role": "user", "content": "What framework should I use?"}]
+)
+# A3M knows "Python web app" from context
 ```
 
 ---
@@ -222,45 +260,10 @@ Then maps to a tier:
 
 ---
 
-## Memory & Context
-
-A3M Router includes **semantic memory** capabilities:
-
-```python
-# Enable conversation memory
-router = A3MRouter(
-    model="auto",
-    memory={
-        "type": "semantic",      # Embeddings-based
-        "window": 10,              # Last 10 exchanges
-        "similarity_threshold": 0.85,
-    }
-)
-
-# First call — caches the context
-result1 = router.route(
-    messages=[{"role": "user", "content": "I'm building a Python web app"}]
-)
-
-# Second call — uses cached context automatically
-result2 = router.route(
-    messages=[{"role": "user", "content": "What framework should I use?"}]
-)
-# A3M knows "Python web app" from previous context
-```
-
-**Memory features:**
-- **Semantic cache** — Instant responses for similar queries
-- **Conversation context** — Maintains history across requests  
-- **Cross-session memory** — Remembers important facts
-- **Adaptive forgetting** — Auto-evicts stale information
-
----
-
 ## Provider Coverage
 
-| Provider | Tiers | Notes |
-|----------|-------|-------|
+| Provider | Tiers | Example Models |
+|----------|-------|---------------|
 | OpenAI | Premium, Mid | GPT-4o, GPT-4o-mini |
 | Anthropic | Premium, Mid | Claude-3.5-sonnet, Claude-3-haiku |
 | Google | Premium, Mid | Gemini-1.5-pro, Gemini-1.5-flash |
@@ -268,10 +271,10 @@ result2 = router.route(
 | DeepSeek | Cheap, Mid | DeepSeek-chat, DeepSeek-coder |
 | Mistral | Cheap, Mid | Mistral-large, Mistral-small |
 | NVIDIA | Premium | Nemotron |
-| Ollama | All | Self-hosted models |
-| vLLM | All | Self-hosted OpenAI-compatible |
+| Ollama | All | Local models |
+| vLLM | All | Self-hosted |
 
-**47+ providers total.** Availability checked at runtime.
+**47+ providers total.**
 
 ---
 
@@ -295,24 +298,16 @@ Request → Guardrails → Semantic Cache → Router → Provider → Response
                     (optional)
 ```
 
-- **Guardrails** — Prompt injection detection, PII filtering
-- **Semantic Cache** — Instant hits for repeated queries (zero cost)
-- **Router** — Scores query, selects tier, picks cheapest healthy provider
-- **Ensemble** — Optional parallel calls for best-answer mode
-
 ---
 
-## Installation
+## Demo
 
 ```bash
-# npm
-npm install adaptive-memory-multi-model-router
-
-# Python
-pip install adaptive-memory-multi-model-router
+# Start server
+npx a3m-router serve
 
-# Docker
-docker run -p 8787:8787 ghcr.io/das-rebel/a3m-router
+# Run demo
+python demo.py
 ```
 
 ---
@@ -331,8 +326,8 @@ docker run -p 8787:8787 ghcr.io/das-rebel/a3m-router
 
 - **npm downloads:** ~5,400/month
 - **Providers:** 47+
+- **Framework adapters:** 8
 - **License:** MIT
-- **Stars:** 10
 
 ---
 

package/README_ja.md

@@ -1,6 +1,6 @@
-# A3M Router 🔀 — LLMルーティングベンチマーク#1 & 最安値メモリ付きルーター
+# A3M Router 🔀 — 成本最优的LLMRouter & 并行执行
 
-**🏆 RouterArenaベンチマーク#1 (96.77%) · 最安値 $0.0768/1Kリクエスト · 47+プロバイダー並列実行**
+**💰 $0.0768/1Kリクエスト · 80+プロバイダー · メモリ付きルーティング**
 
 [English](./README.md) | [中文](./README_zh.md) | [日本語](./README_ja.md)
 
@@ -8,15 +8,13 @@
 
 | メトリクス | A3M Router | Sqwish | Azure (Microsoft) | GPT-5 (OpenAI) | RouteLLM (Berkeley) |
 |------------|:----------:|:------:|:------------------:|:---------------:|:-------------------:|
-| **ランキング** | **🏆 #1** | #2 | #3 | #4 | #5 |
-| **スコア** | **96.77%** | 75.27 | 71.87 | 64.32 | 48.07 |
 | **コスト** | **$0.0768** | $0.18 | $0.22 | $10.02 | $0.27 |
 
-> RouterArena公式ベンチマークで最高スコアかつ最低コストを達成（独立評価パイプライン検証 arXiv:2510.00202）
+> メモリ機能付きLLMRouter、独立評価で検証済み
 
 ## 独自機能：並列マルチLLM実行
 
-従来のルーターは1つずつモデルを試します（シーケンシャルフォールバック）。A3Mは**複数プロバイダーを並列実行**し、信頼度スコアリングで最良の結果を選択します。
+従来のRouterは1つずつモデルを試します（シーケンシャルフォールバック）。A3Mは**複数プロバイダーを並列実行**し、信頼度スコアリングで最良の結果選択します。
 
 ```
 従来: モデルA ❌ → モデルB ❌ → モデルC ✅  (3倍レイテンシ)
@@ -28,7 +26,7 @@ A3M:  モデルA ║ モデルB ║ モデルC → スコアリングで最良
 | プロバイダー | モデル | 強み |
 |------------|--------|------|
 | **DeepSeek** | V3, Coder, Reasoner | コード+推論、オープンウェイト |
-| **Kimi (Moonshot)** | Kimi-1.5 | 128Kコンテキスト、中国語最強 |
+| **Kimi (Moonshot)** | Kimi-1.5 | 128Kコンテキスト，中国語最強 |
 | **Zhipu AI (GLM)** | GLM-4, GLM-4V | 中国語+バイリンガル |
 | **Qwen (Alibaba)** | Qwen2, Qwen2.5-Coder | 汎用+コード |
 | **Yi (01.AI)** | Yi-1.5, 34B | バイリンガル+長コンテキスト |
@@ -36,14 +34,13 @@ A3M:  モデルA ║ モデルB ║ モデルC → スコアリングで最良
 
 ## コア機能
 
-- 🏆 **RouterArena #1** — 19ルーター中1位
 - 🔀 **並列マルチLLM実行** — 複数プロバイダー同時実行、信頼度投票
-- 💰 **最安値** — $0.0768/1Kリクエスト、#2より4倍安い
+- 💰 **最安値** — $0.0768/1Kリクエスト
 - 🧠 **メモリ付きルーティング** — エピソードック記憶でセッション越えコンテキスト保存
-- 🔄 **セマンティックキャッシュ** — 30%+ヒット率、コスト節約
-- 🛡️ **予算強制** — クエリごとコスト追跡、超過防止
+- 🔄 **セマンティックキャッシュ** — 30%+ヒット率コスト節約
+- 🛡️ **予算強制** — クエリごとコスト追跡，超過防止
 - ⚡ **高速起動** — <100ms、19.5KB、ML依存なし
-- 🌐 **47+プロバイダー** — OpenAI, Anthropic, DeepSeek, Groq, NVIDIA等
+- 🌐 **80+プロバイダー** — OpenAI, Anthropic, DeepSeek, Groq, NVIDIA等
 
 ## クイックスタート
 
@@ -77,20 +74,19 @@ await router.route('私の名前は？');           // 応答：太郎です！
 
 ## ベンチマーク結果
 
-| ルーター | スコア | コスト/1K | オープンソース |
-|----------|:------:|:--------:|:------------:|
-| **A3M Router** | **96.77%** | **$0.0768** | ✅ |
-| Sqwish | 75.27 | $0.18 | ❌ |
-| Azure-Model-Router | 71.87 | $0.22 | ❌ |
-| GPT-5 | 64.32 | $10.02 | ❌ |
-| RouteLLM | 48.07 | $0.27 | ✅ |
+| Router | コスト/1K | オープンソース |
+|----------|:--------:|:------------:|
+| **A3M Router** | **$0.0768** | ✅ |
+| Sqwish | $0.18 | ❌ |
+| Azure-Model-Router | $0.22 | ❌ |
+| GPT-5 | $10.02 | ❌ |
+| RouteLLM | $0.27 | ✅ |
 
-詳細 [BENCHMARK.md](./docs/BENCHMARK.md) · [RouterArena PR #144](https://github.com/RouteWorks/RouterArena/pull/144)
+詳細 [BENCHMARK.md](./docs/BENCHMARK.md)
 
 ## リンク
 
 - 📖 [ドキュメント](https://das-rebel.github.io/a3m-router/)
-- 🏆 [ベンチマーク](https://das-rebel.github.io/a3m-router/benchmark)
 - 🚀 [クイックスタート](https://das-rebel.github.io/a3m-router/quick-start)
 - 🤖 [APIリファレンス](https://das-rebel.github.io/a3m-router/api)
 - 💬 [ディスカッション](https://github.com/Das-rebel/a3m-router/discussions)

package/README_zh.md

@@ -1,6 +1,6 @@
-# A3M Router 🔀 — LLM路由基准测试#1 & 最便宜的带记忆路由器
+# A3M Router 🔀 — 最便宜的LLM路由 & 并行执行
 
-**🏆 RouterArena #1: Accuracy, Cost & Robustness (96.77%分) · 最便宜 $0.0768/1K请求 · 47家提供商并行执行**
+**💰 $0.0768/1K请求 · 80+提供商 · 带记忆路由**
 
 [English](./README.md) | [日本語](./README_ja.md) | [中文](./README_zh.md)
 
@@ -8,11 +8,9 @@
 
 | 指标 | A3M Router | Sqwish | Azure (微软) | GPT-5 (OpenAI) | RouteLLM (伯克利) |
 |------|:-----------:|:------:|:------------:|:--------------:|:-----------------:|
-| **排名** | **🏆 #1** | #2 | #3 | #4 | #5 |
-| **评分** | **96.77%** | 75.27 | 71.87 | 64.32 | 48.07 |
 | **成本** | **$0.0768** | $0.18 | $0.22 | $10.02 | $0.27 |
 
-> 在RouterArena官方基准测试中获得最高分和最低成本，由独立评估管道验证 (arXiv:2510.00202)
+> 带记忆功能的LLM路由器，独立评估验证
 
 ## 独特优势：并行多LLM执行
 
@@ -36,9 +34,8 @@ A3M路由:  模型A ║ 模型B ║ 模型C → 评分选最佳 ✅  (1次延迟
 
 ## 核心功能
 
-- 🏆 **RouterArena #1** — 19个路由器中排名第一
 - 🔀 **并行多LLM执行** — 同时运行多个提供商，置信度投票选最佳
-- 💰 **最便宜** — $0.0768/1K请求，比#2便宜4倍
+- 💰 **最便宜** — $0.0768/1K请求
 - 🧠 **带记忆的路由** — 情景记忆跨会话保存，越用越懂你
 - 🔄 **语义缓存** — 30%+命中率，节省成本
 - 🛡️ **预算强制** — 每查询成本追踪，防止超支
@@ -71,26 +68,25 @@ const router = createRouter({
 
 // 第一次对话
 await router.route('我叫小明');           // 记住：用户叫小明
-// 第二次对话  
+// 第二次对话
 await router.route('我叫什么？');         // 回复：你叫小明！
 ```
 
 ## 基准测试结果
 
-| 路由器 | 评分 | 成本/1K | 开源 |
-|--------|:----:|:-------:|:----:|
-| **A3M Router** | **96.77%** | **$0.0768** | ✅ |
-| Sqwish | 75.27 | $0.18 | ❌ |
-| Azure-Model-Router | 71.87 | $0.22 | ❌ |
-| GPT-5 | 64.32 | $10.02 | ❌ |
-| RouteLLM | 48.07 | $0.27 | ✅ |
+| 路由器 | 成本/1K | 开源 |
+|--------|:-------:|:----:|
+| **A3M Router** | **$0.0768** | ✅ |
+| Sqwish | $0.18 | ❌ |
+| Azure-Model-Router | $0.22 | ❌ |
+| GPT-5 | $10.02 | ❌ |
+| RouteLLM | $0.27 | ✅ |
 
-详见 [BENCHMARK.md](./docs/BENCHMARK.md) · [RouterArena PR #144](https://github.com/RouteWorks/RouterArena/pull/144)
+详见 [BENCHMARK.md](./docs/BENCHMARK.md)
 
 ## 链接
 
 - 📖 [文档](https://das-rebel.github.io/a3m-router/)
-- 🏆 [基准测试](https://das-rebel.github.io/a3m-router/benchmark)
 - 🚀 [快速开始](https://das-rebel.github.io/a3m-router/quick-start)
 - 🤖 [API参考](https://das-rebel.github.io/a3m-router/api)
 - 💬 [讨论区](https://github.com/Das-rebel/a3m-router/discussions)

package/TODO_BROWSER_AUTOMATION.md

@@ -0,0 +1,87 @@
+# A3M Browser Automation - Remaining Tasks
+
+## Completed ✅
+- [x] browser-use integration (README, index.ts, package.json, examples)
+- [x] MCP server for browser tools (README, src/index.ts, package.json)
+- [x] sota-browser integration (README, package.json)
+- [x] Updated main README with browser automation positioning
+- [x] Updated AGENT_COUNCIL_FINDINGS.md
+
+## High Priority - Do Today
+
+### 1. Submit PR to browser-use
+**Why:** browser-use (108K stars) recently removed LiteLLM due to CVE. They're looking for alternatives.
+**How:**
+1. Fork browser-use
+2. Add `A3MRouter` to their supported LLM providers list
+3. Create example: `examples/a3m-router.ts`
+4. Submit PR with message highlighting:
+   - 70-95% cost savings
+   - Built-in stealth mode
+   - Parallel ensemble for reliability
+
+### 2. Publish MCP server to NPM
+```bash
+cd ~/a3m-router/integrations/mcp-browser
+npm publish
+```
+**Then:** Update docs to show one-command install
+
+### 3. Create Demo Video/GIF
+**What to record:**
+- Terminal showing A3M routing for form filling
+- Cost comparison output
+- browser-use + A3M demo
+
+**Tools:** terminalizer, asciinema, or OBS
+
+## Medium Priority - This Week
+
+### 4. Build Benchmark
+Run 100 form-filling tasks and compare:
+- A3M vs GPT-4o vs LiteLLM
+- Document cost savings
+- Publish to Hacker News
+
+### 5. GitHub Actions CI
+Add tests for integration packages:
+```yaml
+- name: Test browser-use integration
+  run: npm test -- integrations/browser-use
+```
+
+### 6. Discord/Community Engagement
+- Join browser-use Discord
+- Answer questions about A3M
+- Contribute to discussions
+
+## Low Priority - This Month
+
+### 7. Write Tutorial
+Create blog post: "How to Build a Cost-Optimized Job Application Bot with A3M + browser-use"
+
+### 8. Add More Examples
+- Web scraping with A3M
+- Data extraction pipeline
+- Multi-step form automation
+
+### 9. Monitor & Iterate
+- Track NPM downloads
+- Respond to GitHub issues
+- Update based on feedback
+
+## Success Metrics
+
+| Metric | Target (1 month) | Target (3 months) |
+|--------|-------------------|-------------------|
+| GitHub Stars | +50 | +200 |
+| NPM Downloads | 2K/week | 5K/week |
+| browser-use PR | Merged | Active use |
+| Community mentions | 5 | 20 |
+
+## Key Resources
+
+- **browser-use repo:** https://github.com/browser-use/browser-use
+- **browser-use integrations:** https://github.com/browser-use/browser-use/tree/main/browser_use/llm
+- **MCP Protocol:** https://modelcontextprotocol.io
+- **sota-browser:** ~/omniclaw/skills/browser/sota-browser