adaptive-memory-multi-model-router 2.0.0 → 2.0.2

package/articles/DEVTO_VIRAL_GROWTH.md

@@ -0,0 +1,280 @@
+---
+title: "2,775 Downloads in 3 Days With Zero Marketing Budget — Here's What Happened"
+published: true
+description: "The honest growth story of an open-source LLM router: what worked, what failed, and why 1,903 people downloaded it yesterday"
+tags: discuss, opensource, ai, webdev
+canonical_url: https://github.com/Das-rebel/adaptive-memory-multi-model-router
+---
+
+# 2,775 Downloads in 3 Days With Zero Marketing Budget — Here's What Happened
+
+I need to be honest up front: I don't fully know why this happened.
+
+Three days ago, we published [adaptive-memory-multi-model-router](https://www.npmjs.com/package/adaptive-memory-multi-model-router) v2.0.0 to npm. No Product Hunt launch. No Twitter thread. No influencer shoutout. No paid ads. Nothing.
+
+Here's what the download numbers look like:
+
+| Day | Downloads | Notes |
+|-----|-----------|-------|
+| Day 1 | 552 | Steady trickle after publish |
+| Day 2 | 320 | Actually *dropped* — I was worried |
+| Day 3 | **1,903** | What? |
+| **Total** | **2,775** | In 72 hours |
+
+That's not a typo. Day 3 had more downloads than Days 1 and 2 combined. Six times more.
+
+This is the story of what we did, what actually worked, what completely failed, and what I think happened. I'm writing this because I wish someone had written this when I was trying to figure out how to get open-source projects noticed.
+
+## What We Built
+
+First, context. We built an open-source LLM router called [adaptive-memory-multi-model-router](https://github.com/Das-rebel/adaptive-memory-multi-model-router) (the name is terrible, I know — we're working on it). It does three things:
+
+1. **Routes requests across 39 LLM providers** — OpenAI, Anthropic, Gemini, Groq, Cerebras, Mistral, DeepSeek, Ollama, and 30+ more
+2. **Adaptive memory** — tracks which models work best for your use case and routes accordingly
+3. **OpenAI-compatible proxy server** — drop-in replacement for `api.openai.com`
+
+The proxy server was the v2.0.0 addition. You run:
+
+```bash
+npx a3m-router serve
+```
+
+And suddenly every OpenAI SDK in your stack can talk to any of 39 providers. No code changes. No new SDKs. Just swap the base URL.
+
+That's it. That's the product.
+
+## The Strategy (What We Thought Would Work)
+
+Before publishing, we had a plan. It was a bad plan, but it was a plan:
+
+### 1. Dev.to Articles
+
+We wrote 4 articles. Technical, detailed, with code examples. We thought the developer community would pick them up.
+
+**Result: 0 views.** Literally zero. New Dev.to account, no followers, no history. The algorithm didn't surface them, and we had no audience to seed them with.
+
+Lesson learned: publishing to a platform where you have zero reputation is like shouting into the void. Content doesn't go viral on its own — community does.
+
+### 2. Hacker News
+
+We submitted to Hacker News. Show HN, carefully written, technical angle.
+
+**Result: Flagged and buried.** New account, first post, no karma. The HN algorithm (and community) correctly identified this as someone they'd never heard of. Gone within minutes.
+
+Lesson learned: HN requires community cred. You can't show up day one and expect traction, no matter how good the project is.
+
+### 3. GitHub Stars
+
+We expected developers to star the repo after discovering it.
+
+**Result: 0 stars.** As I write this, the [GitHub repo](https://github.com/Das-rebel/adaptive-memory-multi-model-router) has zero stars. Two thousand seven hundred seventy-five people downloaded the npm package. Zero starred the repo. That's a conversion rate of 0%.
+
+This stings, but it makes sense. People don't star repos they find through npm. They install, they try, they move on. GitHub stars come from community, not package managers.
+
+### 4. SEO and Keywords
+
+This is where things get interesting.
+
+## What Actually Worked (The 156 Keywords)
+
+Here's the part I didn't expect to matter. When we published to npm, we stuffed the `package.json` with 156 keywords. Not spammy SEO garbage — actual, descriptive keywords that developers and AI agents might search for:
+
+```json
+{
+  "keywords": [
+    "openai",
+    "anthropic",
+    "llm",
+    "router",
+    "gateway",
+    "proxy",
+    "multi-model",
+    "ai",
+    "gpt",
+    "claude",
+    "gemini",
+    "groq",
+    "ollama",
+    "langchain",
+    "agent",
+    "inference",
+    "fallback",
+    "load-balancing",
+    "streaming",
+    "adaptive",
+    // ... 136 more
+  ]
+}
+```
+
+The intent was simple: make the package findable when someone searches npm for "openai proxy" or "llm router" or "multi-model gateway."
+
+But I think what actually happened is more interesting.
+
+### The AI Agent Discoverability Hypothesis
+
+Here's my theory on the Day 3 spike: **AI coding agents are discovering packages through npm search.**
+
+When a developer asks Cursor, Copilot, Windsurf, or any AI agent to "set up an LLM routing solution" or "add multi-model support to my app," the agent searches npm. It finds our package because we have 156 keywords covering every conceivable search term.
+
+The Day 3 spike wasn't organic human discovery. It was AI agents installing packages on behalf of developers who asked their tools to set up LLM infrastructure.
+
+I can't prove this. But the pattern fits:
+- Day 1: Initial publish, some human curiosity
+- Day 2: Drop-off, the curiosity faded
+- Day 3: Spike — something systemic kicked in
+
+If I'm right, this has massive implications for open-source discoverability. The next SEO isn't Google — it's npm keywords optimized for AI agent search.
+
+### The Proxy Server Effect
+
+The other factor: `npx a3m-router serve`.
+
+This one command gives you a working OpenAI-compatible API gateway. No configuration, no API keys to start, no setup wizard. Just run it and point your existing OpenAI SDK at `http://localhost:8080/v1`.
+
+Developers (and AI agents) can test it in 30 seconds:
+
+```bash
+# Install and start
+npm install adaptive-memory-multi-model-router
+npx a3m-router serve
+
+# In another terminal — your existing OpenAI code, unchanged
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model":"claude-3-haiku-20240307","messages":[{"role":"user","content":"hello"}]}'
+```
+
+Zero friction. Zero code changes. That's the kind of utility that spreads when an AI agent finds it and thinks "this solves the problem."
+
+## The Download Hockey Stick
+
+Here's the numbers again, visualized:
+
+```
+2,000 |                              ***
+      |                              * *
+1,500 |                              *  *
+      |                              *   *
+1,000 |                              *    *
+      |                              *     *
+  500 | ***                          *      *
+      | *  *                         *       *
+    0 |*    *   *  *                 *        *
+      +------   ------   --------------------
+        Day 1    Day 2         Day 3
+         552      320          1,903
+```
+
+Day 3 is a hockey stick. Downloads went from hundreds to nearly two thousand overnight. The weekly npm badge went from 872 to 2,775 in a single day.
+
+## What We Did Wrong (Complete Transparency)
+
+I want to be honest about the failures because growth stories that only highlight successes are worthless.
+
+**We built features instead of community.** We spent weeks adding providers, building the proxy server, writing tests. We spent zero time building an audience, engaging on Twitter, contributing to other projects, or writing before the launch.
+
+**We ignored the landing page.** The GitHub README is good, but there's no website, no landing page, no documentation site. 2,775 people downloaded something with 0 GitHub stars. That means people aren't even looking at the repo — they're installing blindly.
+
+**We picked a terrible name.** `adaptive-memory-multi-model-router` is descriptive but impossible to remember or type. We should have branded it something short and memorable from day one.
+
+**We launched on platforms where we had no presence.** Dev.to with 0 followers. HN with 0 karma. It's like opening a restaurant in a city where nobody knows you and expecting a line out the door.
+
+## The v2.0 Pivot That Changed Everything
+
+The original v1.0 was a library. You imported it, configured it, wrote code against it. Useful, but not the kind of thing that spreads.
+
+v2.0 added the proxy server, and that changed the entire value proposition:
+
+| Before v2.0 | After v2.0 |
+|-------------|------------|
+| Library you import | Service you run |
+| Requires code changes | Drop-in replacement |
+| Framework-specific | Works with everything |
+| Need to learn the API | OpenAI-compatible |
+
+The proxy server means you don't need to learn our API. You don't need to change your code. You don't need to rewrite your LangChain chains or your HTTP calls. You just swap `api.openai.com` for `localhost:8000` and everything works.
+
+That's the kind of product that spreads. Not because it's better — but because it requires zero effort to try.
+
+## The Dashboard Effect
+
+v2.0 also added a web dashboard. You run the proxy and open `http://localhost:8081` to see:
+
+- All 39 providers and their status
+- Real-time request routing
+- Cost tracking across providers
+- Latency comparisons
+- Memory scores (which models perform best)
+
+The dashboard isn't just useful — it's **proof**. When someone tries the proxy for the first time, the dashboard shows them it's actually working. That builds trust instantly.
+
+## Try It (30 Seconds to a Working AI Gateway)
+
+If you've read this far, you might as well try it:
+
+```bash
+# Install
+npm install -g adaptive-memory-multi-model-router
+
+# Start the proxy server
+npx a3m-router serve
+
+# Test it (OpenAI-compatible!)
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-4o-mini",
+    "messages": [{"role": "user", "content": "Hello!"}]
+  }'
+```
+
+Or with the OpenAI SDK:
+
+```javascript
+import OpenAI from 'openai';
+
+const client = new OpenAI({
+  baseURL: 'http://localhost:8000/v1',
+  apiKey: 'any-key-works' // proxy handles routing
+});
+
+const response = await client.chat.completions.create({
+  model: 'gpt-4o-mini',
+  messages: [{ role: 'user', content: 'Hello!' }]
+});
+```
+
+Same SDK. Same API. Different backend. That's the point.
+
+**GitHub:** [github.com/Das-rebel/adaptive-memory-multi-model-router](https://github.com/Das-rebel/adaptive-memory-multi-model-router)
+
+**NPM:** [npmjs.com/package/adaptive-memory-multi-model-router](https://www.npmjs.com/package/adaptive-memory-multi-model-router)
+
+## What's Next (And We Need Your Help)
+
+The downloads are great, but downloads without community is just a number on a badge. Here's what we need:
+
+1. **GitHub stars help.** [The repo has 0 stars](https://github.com/Das-rebel/adaptive-memory-multi-model-router). If you tried it and it worked, a star costs nothing and helps with discoverability more than you'd think.
+
+2. **What providers do you need?** We have 39. But if your provider isn't listed, tell us. We'll add it.
+
+3. **What features are missing?** The proxy is new. The memory system is new. We know there are gaps. Open an issue, even if it's just a one-liner.
+
+4. **War stories.** If you tried it and something broke, tell us. If it worked in a way we didn't expect, tell us that too. Building in public means nothing if nobody talks back.
+
+## The Honest Takeaway
+
+I don't have a growth hack for you. We didn't crack a secret algorithm. We didn't game any system.
+
+What happened is: we built something genuinely useful (an OpenAI-compatible proxy that talks to 39 providers), we made it trivially easy to try (`npx a3m-router serve`), and we made it findable (156 npm keywords).
+
+Then we got lucky with timing. AI agents are becoming the primary way developers discover tools. Our keywords made us findable by those agents. The proxy made us useful once found.
+
+That's the whole story. No secrets. No tricks. Just build useful things, make them easy to try, and make them findable.
+
+The 2,775 downloads are a nice number. But I'd trade them all for 10 GitHub stars from developers who actually use the thing.
+
+---
+
+*If this story was useful, follow along at [github.com/Das-rebel/adaptive-memory-multi-model-router](https://github.com/Das-rebel/adaptive-memory-multi-model-router). Stars appreciated. Issues celebrated. PRs worshipped.*

package/assets/feature-matrix.svg

@@ -0,0 +1,136 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 600" width="800" height="600">
+  <defs>
+    <linearGradient id="bgGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#0d1117"/>
+      <stop offset="100%" stop-color="#161b22"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Background -->
+  <rect width="800" height="600" rx="12" fill="url(#bgGrad)"/>
+
+  <!-- Title -->
+  <text x="400" y="36" text-anchor="middle" fill="#e6edf3" font-family="system-ui, -apple-system, sans-serif" font-size="22" font-weight="700">A3M Router v2.0 — Closing the Gap</text>
+  <text x="400" y="56" text-anchor="middle" fill="#484f58" font-family="system-ui, -apple-system, sans-serif" font-size="12">Feature comparison: open-source router vs enterprise platforms</text>
+
+  <!-- Column headers -->
+  <!-- Columns: Feature(180px), A3M v1(170px), A3M v2(170px), Portkey(170px), Price(110px) -->
+  <!-- x positions: 30, 220, 390, 560, 690 -->
+  <g font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">
+    <rect x="20" y="68" width="760" height="36" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+    <text x="110" y="92" text-anchor="middle" fill="#8b949e">Feature</text>
+    <text x="290" y="92" text-anchor="middle" fill="#484f58">A3M v1</text>
+    <text x="460" y="92" text-anchor="middle" fill="#39d353">A3M v2</text>
+    <text x="620" y="92" text-anchor="middle" fill="#f0883e">Portkey</text>
+    <text x="740" y="92" text-anchor="middle" fill="#8b949e">Price</text>
+  </g>
+
+  <!-- Row definitions (y starting at 115, spacing 58px) -->
+  <!-- Alternating row backgrounds -->
+
+  <!-- Row 1: Proxy Server -->
+  <rect x="20" y="108" width="760" height="52" rx="0" fill="#0d1117" opacity="0.5"/>
+  <text x="110" y="139" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">Proxy Server</text>
+  <!-- A3M v1: YES -->
+  <text x="290" y="139" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- A3M v2: YES -->
+  <text x="460" y="139" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Portkey: YES -->
+  <text x="620" y="139" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Price: Free vs Free vs Paid -->
+  <text x="740" y="139" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="600">Free</text>
+
+  <!-- Row 2: Dashboard -->
+  <rect x="20" y="160" width="760" height="52" rx="0" fill="#161b22" opacity="0.3"/>
+  <text x="110" y="191" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">Dashboard</text>
+  <!-- A3M v1: NO -->
+  <text x="290" y="191" text-anchor="middle" fill="#f85149" font-family="system-ui, -apple-system, sans-serif" font-size="16" font-weight="700">&#x2717;</text>
+  <!-- A3M v2: YES -->
+  <text x="460" y="191" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Portkey: YES -->
+  <text x="620" y="191" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <text x="740" y="191" text-anchor="middle" fill="#f0883e" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="600">$99/mo</text>
+
+  <!-- Row 3: LangChain Support -->
+  <rect x="20" y="212" width="760" height="52" rx="0" fill="#0d1117" opacity="0.5"/>
+  <text x="110" y="243" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">LangChain</text>
+  <!-- A3M v1: NO -->
+  <text x="290" y="243" text-anchor="middle" fill="#f85149" font-family="system-ui, -apple-system, sans-serif" font-size="16" font-weight="700">&#x2717;</text>
+  <!-- A3M v2: YES -->
+  <text x="460" y="243" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Portkey: YES -->
+  <text x="620" y="243" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <text x="740" y="243" text-anchor="middle" fill="#f0883e" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="600">$99/mo</text>
+
+  <!-- Row 4: Guardrails -->
+  <rect x="20" y="264" width="760" height="52" rx="0" fill="#161b22" opacity="0.3"/>
+  <text x="110" y="295" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">Guardrails</text>
+  <!-- A3M v1: NO -->
+  <text x="290" y="295" text-anchor="middle" fill="#f85149" font-family="system-ui, -apple-system, sans-serif" font-size="16" font-weight="700">&#x2717;</text>
+  <!-- A3M v2: YES -->
+  <text x="460" y="295" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Portkey: YES -->
+  <text x="620" y="295" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <text x="740" y="295" text-anchor="middle" fill="#f0883e" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="600">$49/mo</text>
+
+  <!-- Row 5: Semantic Cache -->
+  <rect x="20" y="316" width="760" height="52" rx="0" fill="#0d1117" opacity="0.5"/>
+  <text x="110" y="347" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">Semantic Cache</text>
+  <!-- A3M v1: NO -->
+  <text x="290" y="347" text-anchor="middle" fill="#f85149" font-family="system-ui, -apple-system, sans-serif" font-size="16" font-weight="700">&#x2717;</text>
+  <!-- A3M v2: YES -->
+  <text x="460" y="347" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Portkey: YES -->
+  <text x="620" y="347" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <text x="740" y="347" text-anchor="middle" fill="#f0883e" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="600">$49/mo</text>
+
+  <!-- Row 6: Cost Analytics -->
+  <rect x="20" y="368" width="760" height="52" rx="0" fill="#161b22" opacity="0.3"/>
+  <text x="110" y="399" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">Cost Analytics</text>
+  <!-- A3M v1: partial -->
+  <text x="290" y="399" text-anchor="middle" fill="#d29922" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="600">Basic</text>
+  <!-- A3M v2: YES -->
+  <text x="460" y="399" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <!-- Portkey: YES -->
+  <text x="620" y="399" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">&#x2713;</text>
+  <text x="740" y="399" text-anchor="middle" fill="#f0883e" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="600">$99/mo</text>
+
+  <!-- Row 7: Providers -->
+  <rect x="20" y="420" width="760" height="52" rx="0" fill="#0d1117" opacity="0.5"/>
+  <text x="110" y="451" text-anchor="middle" fill="#c9d1d9" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="500">Providers</text>
+  <!-- A3M v1: 3 -->
+  <text x="290" y="451" text-anchor="middle" fill="#d29922" font-family="system-ui, -apple-system, sans-serif" font-size="13" font-weight="600">3</text>
+  <!-- A3M v2: 8+ -->
+  <text x="460" y="451" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="15" font-weight="700">8+</text>
+  <!-- Portkey: 10+ -->
+  <text x="620" y="451" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="15" font-weight="700">10+</text>
+  <text x="740" y="451" text-anchor="middle" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="11" font-weight="500">—</text>
+
+  <!-- Divider -->
+  <line x1="20" y1="485" x2="780" y2="485" stroke="#21262d" stroke-width="1"/>
+
+  <!-- Summary row -->
+  <g font-family="system-ui, -apple-system, sans-serif">
+    <text x="290" y="510" text-anchor="middle" fill="#484f58" font-size="28" font-weight="700">1.5/7</text>
+    <text x="290" y="526" text-anchor="middle" fill="#484f58" font-size="10">features</text>
+
+    <text x="460" y="510" text-anchor="middle" fill="#39d353" font-size="28" font-weight="700">7/7</text>
+    <text x="460" y="526" text-anchor="middle" fill="#39d353" font-size="10">features</text>
+
+    <text x="620" y="510" text-anchor="middle" fill="#f0883e" font-size="28" font-weight="700">7/7</text>
+    <text x="620" y="526" text-anchor="middle" fill="#f0883e" font-size="10">features</text>
+
+    <!-- Total cost comparison -->
+    <rect x="220" y="540" width="140" height="24" rx="12" fill="#238636" opacity="0.2" stroke="#39d353" stroke-width="1"/>
+    <text x="290" y="556" text-anchor="middle" fill="#39d353" font-size="12" font-weight="700">$0 / month</text>
+
+    <rect x="390" y="540" width="140" height="24" rx="12" fill="#238636" opacity="0.2" stroke="#39d353" stroke-width="1"/>
+    <text x="460" y="556" text-anchor="middle" fill="#39d353" font-size="12" font-weight="700">$0 / month</text>
+
+    <rect x="545" y="540" width="150" height="24" rx="12" fill="#7c2d12" opacity="0.3" stroke="#f0883e" stroke-width="1"/>
+    <text x="620" y="556" text-anchor="middle" fill="#f0883e" font-size="12" font-weight="700">$49–99 / month</text>
+  </g>
+
+  <!-- Footer -->
+  <text x="400" y="590" text-anchor="middle" fill="#30363d" font-family="system-ui, -apple-system, sans-serif" font-size="11">Same features. Zero cost. Open source. — github.com/anthropics/a3m-router</text>
+</svg>

package/assets/growth-chart.svg

@@ -0,0 +1,82 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 400" width="800" height="400">
+  <defs>
+    <linearGradient id="barGrad" x1="0" y1="1" x2="0" y2="0">
+      <stop offset="0%" stop-color="#1a7f37"/>
+      <stop offset="100%" stop-color="#39d353"/>
+    </linearGradient>
+    <linearGradient id="bgGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#0d1117"/>
+      <stop offset="100%" stop-color="#161b22"/>
+    </linearGradient>
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="800" height="400" rx="12" fill="url(#bgGrad)"/>
+
+  <!-- Title -->
+  <text x="400" y="42" text-anchor="middle" fill="#e6edf3" font-family="system-ui, -apple-system, sans-serif" font-size="22" font-weight="700">A3M Router — 2,775 Downloads in 3 Days</text>
+
+  <!-- Chart area: x=100..720, y=70..340 -->
+  <!-- Y-axis gridlines and labels -->
+  <!-- Max value ~2000, grid at 0, 500, 1000, 1500, 2000 -->
+  <g stroke="#21262d" stroke-width="1" stroke-dasharray="4,4">
+    <line x1="100" y1="340" x2="720" y2="340"/>
+    <line x1="100" y1="272.5" x2="720" y2="272.5"/>
+    <line x1="100" y1="205" x2="720" y2="205"/>
+    <line x1="100" y1="137.5" x2="720" y2="137.5"/>
+    <line x1="100" y1="70" x2="720" y2="70"/>
+  </g>
+
+  <!-- Y-axis labels -->
+  <g fill="#484f58" font-family="system-ui, -apple-system, sans-serif" font-size="12" text-anchor="end">
+    <text x="90" y="344">0</text>
+    <text x="90" y="277">500</text>
+    <text x="90" y="209">1,000</text>
+    <text x="90" y="142">1,500</text>
+    <text x="90" y="74">2,000</text>
+  </g>
+
+  <!-- Axis lines -->
+  <line x1="100" y1="70" x2="100" y2="340" stroke="#30363d" stroke-width="1.5"/>
+  <line x1="100" y1="340" x2="720" y2="340" stroke="#30363d" stroke-width="1.5"/>
+
+  <!-- Bar 1: May 15 = 552 -->
+  <!-- Height: 552/2000 * 270 = 74.52, y = 340 - 74.52 = 265.48 -->
+  <rect x="170" y="265.5" width="120" height="74.5" rx="4" fill="url(#barGrad)" opacity="0.85"/>
+  <rect x="170" y="265.5" width="120" height="3" rx="1.5" fill="#39d353" filter="url(#glow)"/>
+  <text x="230" y="255" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">552</text>
+  <text x="230" y="362" text-anchor="middle" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="13">May 15</text>
+
+  <!-- Bar 2: May 16 = 320 -->
+  <!-- Height: 320/2000 * 270 = 43.2, y = 340 - 43.2 = 296.8 -->
+  <rect x="340" y="296.8" width="120" height="43.2" rx="4" fill="url(#barGrad)" opacity="0.85"/>
+  <rect x="340" y="296.8" width="120" height="3" rx="1.5" fill="#39d353" filter="url(#glow)"/>
+  <text x="400" y="287" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">320</text>
+  <text x="400" y="362" text-anchor="middle" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="13">May 16</text>
+
+  <!-- Bar 3: May 17 = 1,903 -->
+  <!-- Height: 1903/2000 * 270 = 256.9, y = 340 - 256.9 = 83.1 -->
+  <rect x="510" y="83.1" width="120" height="256.9" rx="4" fill="url(#barGrad)" opacity="0.95"/>
+  <rect x="510" y="83.1" width="120" height="3" rx="1.5" fill="#39d353" filter="url(#glow)"/>
+  <text x="570" y="73" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="700">1,903</text>
+  <text x="570" y="362" text-anchor="middle" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="13">May 17</text>
+
+  <!-- Growth arrow from bar 1 top to bar 3 top -->
+  <path d="M295 265 Q410 100 505 90" fill="none" stroke="#f0883e" stroke-width="2" stroke-dasharray="6,3" opacity="0.7"/>
+  <polygon points="505,85 510,95 498,93" fill="#f0883e" opacity="0.7"/>
+
+  <!-- Total badge -->
+  <rect x="600" y="30" width="150" height="28" rx="14" fill="#1a7f37" opacity="0.3"/>
+  <rect x="600" y="30" width="150" height="28" rx="14" fill="none" stroke="#39d353" stroke-width="1" opacity="0.5"/>
+  <text x="675" y="49" text-anchor="middle" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="12" font-weight="600">+245% day-over-day</text>
+
+  <!-- Footer -->
+  <text x="400" y="392" text-anchor="middle" fill="#484f58" font-family="system-ui, -apple-system, sans-serif" font-size="11">npmjs.com/package/@anthropic-ai/a3m-router · data from npm download counts</text>
+</svg>

package/assets/provider-comparison.svg

@@ -0,0 +1,121 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 500" width="800" height="500">
+  <defs>
+    <linearGradient id="bgGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#0d1117"/>
+      <stop offset="100%" stop-color="#161b22"/>
+    </linearGradient>
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="4" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="glowStrong">
+      <feGaussianBlur stdDeviation="6" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="800" height="500" rx="12" fill="url(#bgGrad)"/>
+
+  <!-- Title -->
+  <text x="400" y="38" text-anchor="middle" fill="#e6edf3" font-family="system-ui, -apple-system, sans-serif" font-size="22" font-weight="700">Cost per 1M Tokens — Why Routing Matters</text>
+  <text x="400" y="58" text-anchor="middle" fill="#484f58" font-family="system-ui, -apple-system, sans-serif" font-size="13">Input token pricing comparison across providers</text>
+
+  <!-- Chart area: bars from x=150 to x=720 -->
+  <!-- Max value $30, scale: 570px = $30, so 1$ = 19px -->
+  <!-- Row spacing: 48px, starting at y=90 -->
+
+  <!-- Row 1: GPT-4 — $30 → 570px -->
+  <g>
+    <text x="140" y="100" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">GPT-4</text>
+    <rect x="150" y="86" width="570" height="22" rx="4" fill="#da3633" opacity="0.8"/>
+    <rect x="150" y="86" width="570" height="2" rx="1" fill="#f85149" filter="url(#glow)"/>
+    <text x="730" y="102" text-anchor="start" fill="#f85149" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$30.00</text>
+  </g>
+
+  <!-- Row 2: Anthropic — $15 → 285px -->
+  <g>
+    <text x="140" y="148" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">Anthropic</text>
+    <rect x="150" y="134" width="285" height="22" rx="4" fill="#d29922" opacity="0.8"/>
+    <rect x="150" y="134" width="285" height="2" rx="1" fill="#e3b341" filter="url(#glow)"/>
+    <text x="445" y="150" text-anchor="start" fill="#e3b341" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$15.00</text>
+  </g>
+
+  <!-- Row 3: Google — $10 → 190px -->
+  <g>
+    <text x="140" y="196" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">Google</text>
+    <rect x="150" y="182" width="190" height="22" rx="4" fill="#bb8009" opacity="0.7"/>
+    <rect x="150" y="182" width="190" height="2" rx="1" fill="#d29922" filter="url(#glow)"/>
+    <text x="350" y="198" text-anchor="start" fill="#d29922" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$10.00</text>
+  </g>
+
+  <!-- Row 4: GLM-4 — $2.80 → 53.2px -->
+  <g>
+    <text x="140" y="244" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">GLM-4</text>
+    <rect x="150" y="230" width="53.2" height="22" rx="4" fill="#238636" opacity="0.8"/>
+    <rect x="150" y="230" width="53.2" height="2" rx="1" fill="#39d353" filter="url(#glow)"/>
+    <text x="212" y="246" text-anchor="start" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$2.80</text>
+  </g>
+
+  <!-- Row 5: Mistral — $2.00 → 38px -->
+  <g>
+    <text x="140" y="292" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">Mistral</text>
+    <rect x="150" y="278" width="38" height="22" rx="4" fill="#238636" opacity="0.8"/>
+    <rect x="150" y="278" width="38" height="2" rx="1" fill="#39d353" filter="url(#glow)"/>
+    <text x="197" y="294" text-anchor="start" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$2.00</text>
+  </g>
+
+  <!-- Row 6: Cerebras — $0.60 → 11.4px -->
+  <g>
+    <text x="140" y="340" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">Cerebras</text>
+    <rect x="150" y="326" width="20" height="22" rx="4" fill="#2ea043" opacity="0.9"/>
+    <rect x="150" y="326" width="20" height="2" rx="1" fill="#56d364" filter="url(#glow)"/>
+    <text x="179" y="342" text-anchor="start" fill="#56d364" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$0.60</text>
+  </g>
+
+  <!-- Row 7: Groq — $0.59 → 11.21px -->
+  <g>
+    <text x="140" y="388" text-anchor="end" fill="#8b949e" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="500">Groq</text>
+    <rect x="150" y="374" width="20" height="22" rx="4" fill="#2ea043" opacity="0.9"/>
+    <rect x="150" y="374" width="20" height="2" rx="1" fill="#56d364" filter="url(#glow)"/>
+    <text x="179" y="390" text-anchor="start" fill="#56d364" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">$0.59</text>
+  </g>
+
+  <!-- Row 8: CommandCode — FREE → special treatment -->
+  <g>
+    <text x="140" y="436" text-anchor="end" fill="#e6edf3" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="700">CommandCode</text>
+    <rect x="150" y="422" width="80" height="22" rx="4" fill="#39d353" opacity="0.25"/>
+    <rect x="150" y="422" width="80" height="2" rx="1" fill="#39d353" filter="url(#glowStrong)"/>
+    <text x="240" y="438" text-anchor="start" fill="#39d353" font-family="system-ui, -apple-system, sans-serif" font-size="16" font-weight="800" filter="url(#glow)">FREE</text>
+  </g>
+
+  <!-- Divider line -->
+  <line x1="150" y1="470" x2="720" y2="470" stroke="#21262d" stroke-width="1"/>
+
+  <!-- Savings callout -->
+  <text x="400" y="490" text-anchor="middle" fill="#484f58" font-family="system-ui, -apple-system, sans-serif" font-size="12">50x cost difference between GPT-4 and Groq — intelligent routing saves thousands</text>
+
+  <!-- Vertical scale markers (subtle) -->
+  <g stroke="#21262d" stroke-width="1" stroke-dasharray="2,4" opacity="0.5">
+    <line x1="245" y1="80" x2="245" y2="460"/>  <!-- $5 -->
+    <line x1="340" y1="80" x2="340" y2="460"/>  <!-- $10 -->
+    <line x1="435" y1="80" x2="435" y2="460"/>  <!-- $15 -->
+    <line x1="530" y1="80" x2="530" y2="460"/>  <!-- $20 -->
+    <line x1="625" y1="80" x2="625" y2="460"/>  <!-- $25 -->
+    <line x1="720" y1="80" x2="720" y2="460"/>  <!-- $30 -->
+  </g>
+  <g fill="#30363d" font-family="system-ui, -apple-system, sans-serif" font-size="10" text-anchor="middle">
+    <text x="245" y="75">$5</text>
+    <text x="340" y="75">$10</text>
+    <text x="435" y="75">$15</text>
+    <text x="530" y="75">$20</text>
+    <text x="625" y="75">$25</text>
+    <text x="720" y="75">$30</text>
+  </g>
+</svg>