diff --git a/README.md b/README.md index 45c9374fb1..2e6a70aa1e 100644 --- a/README.md +++ b/README.md @@ -186,24 +186,7 @@
-``` -┌──────────────────────────────────────────────────────────┐ -│ Your IDE / CLI (Claude Code, Cursor, Cline…) │ -└─────────────────────────┬──────────────────────────────────┘ - │ http://localhost:20128/v1 - ▼ -┌──────────────────────────────────────────────────────────┐ -│ OmniRoute — Smart Router │ -│ RTK + Caveman compression · 18 routing strategies │ -│ Circuit breakers · TLS stealth · MCP · A2A · Guardrails │ -└─────────────────────────┬──────────────────────────────────┘ - ┌─────────────┬────┴────────┬─────────────┐ - ▼ Tier 1 ▼ Tier 2 ▼ Tier 3 ▼ Tier 4 - SUBSCRIPTION API KEY CHEAP FREE - Claude Code, DeepSeek, GLM $0.5, Kiro, Qoder, - Codex, Copilot Groq, xAI MiniMax $0.2 Pollinations - quota out? ───▶ budget hit? ─▶ budget hit? ─▶ always on -``` +OmniRoute request flow: your IDE or CLI (Claude Code, Cursor, Cline…) calls one local endpoint (http://localhost:20128/v1); the OmniRoute Smart Router (RTK + Caveman compression, 18 routing strategies, circuit breakers, TLS stealth, MCP, A2A, guardrails) auto-falls back across 4 provider tiers — Tier 1 Subscription (Claude Code, Codex, Copilot), quota out? Tier 2 API Key (DeepSeek, Groq, xAI), budget hit? Tier 3 Cheap (GLM $0.5, MiniMax $0.2), budget hit? Tier 4 Free (Kiro, Qoder, Pollinations) — always on.
diff --git a/changelog.d/maintenance/7615-readme-tier-cascade-svg.md b/changelog.d/maintenance/7615-readme-tier-cascade-svg.md new file mode 100644 index 0000000000..593427f876 --- /dev/null +++ b/changelog.d/maintenance/7615-readme-tier-cascade-svg.md @@ -0,0 +1 @@ +- **README tier-cascade diagram animated** (`docs/diagrams/tier-cascade.svg`): the ASCII 4-tier auto-fallback block in the README is now a self-contained animated SVG (SMIL-only, 16 KB, 16s loop in 4 acts — quota-out/budget-hit hand-offs down to the always-on free tier) that plays inside GitHub's `` sandbox; full flow preserved in the img alt text, hand-authored-diagrams section added to `docs/diagrams/README.md` (#7615). diff --git a/docs/diagrams/README.md b/docs/diagrams/README.md index c13a411222..2de1805fe3 100644 --- a/docs/diagrams/README.md +++ b/docs/diagrams/README.md @@ -1,7 +1,7 @@ --- title: "Diagrams" -version: 3.8.40 -lastUpdated: 2026-06-28 +version: 3.8.49 +lastUpdated: 2026-07-17 --- # Diagrams @@ -21,6 +21,16 @@ Mermaid sources (`.mmd`) and exported SVGs for OmniRoute v3.8.0 architecture flo | [authz-pipeline.mmd](./authz-pipeline.mmd) | [SVG](./exported/authz-pipeline.svg) | docs/architecture/AUTHZ_GUIDE.md | | [db-schema-overview.mmd](./db-schema-overview.mmd) | [SVG](./exported/db-schema-overview.svg) | docs/architecture/CODEBASE_DOCUMENTATION.md | +## Hand-authored animated diagrams + +Not every diagram comes from a `.mmd` source. Hand-authored SVGs live at this +directory's root and animate with SMIL only (no JS, no external fonts), so they play +inside GitHub's `` sandbox: + +| File | Used in | Notes | +| ---------------------------------------- | ---------------- | ---------------------------------------------------------------------------- | +| [tier-cascade.svg](./tier-cascade.svg) | README.md (root) | Animated 4-tier auto-fallback cascade (16s loop, 4 acts). Edit the SVG directly — there is no `.mmd` source. | + ## How to update 1. Edit `*.mmd`. diff --git a/docs/diagrams/tier-cascade.svg b/docs/diagrams/tier-cascade.svg new file mode 100644 index 0000000000..4f819814fd --- /dev/null +++ b/docs/diagrams/tier-cascade.svg @@ -0,0 +1,269 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Your IDE / CLI + Claude Code · Cursor · Cline · every AI tool + + + + + + + http://localhost:20128/v1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + OmniRoute — Smart Router + RTK + Caveman compression · 18 routing strategies + Circuit breakers · TLS stealth · MCP · A2A · Guardrails + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + TIER 1 · SUBSCRIPTION + + + + + + + Claude Code + Codex + Copilot + + + + + + + + + + TIER 2 · API KEY + + + + + + + DeepSeek + Groq + xAI + + + + + + + + + + TIER 3 · CHEAP + + + + + + + GLM $0.5 + MiniMax $0.2 + + + + + + + + + + TIER 4 · FREE + + + + + + Kiro + Qoder + Pollinations + + + + + + + + + + + + + quota out? + + + + budget hit? + + + + budget hit? + + + + + + + + + + + + + + + + + + + + + + + + ALWAYS ON + + + + AUTO-FALLBACK CASCADE · NEVER STOP CODING +