{"_id":"9router-plus","_rev":"6-c66b62bb86a0cf04850c5c8da9e11d91","name":"9router-plus","dist-tags":{"latest":"0.5.5"},"versions":{"0.5.0":{"name":"9router-plus","version":"0.5.0","keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"author":{"name":"rickicode"},"license":"MIT","_id":"9router-plus@0.5.0","maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"homepage":"https://github.com/rickicode/9router#readme","bugs":{"url":"https://github.com/rickicode/9router/issues"},"dist":{"shasum":"3df6d8135c5763fb6fe448f577904d8ff25d51a0","tarball":"https://registry.npmjs.org/9router-plus/-/9router-plus-0.5.0.tgz","fileCount":232,"integrity":"sha512-VCTxXC2cAWF1/ZJoJeWMvApxcnysRtIGjcrq19Vm05jynUMZJmU1MzTm/KZhlkUYctLIrLNjnGoX/nlbz+C8ZA==","signatures":[{"sig":"MEQCIGffxFMswyLpHGXfSpj3k65jGsG4FZEmueuqdwdxytptAiAGJXWRf6mu/5+2qge4zVez9H3esKdCdt9e/fSNAA5h3w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2022645},"gitHead":"f2e5f3f95903f6734580fc368245bb1f7f31da3e","private":false,"scripts":{"dev":"next dev --hostname 127.0.0.1 --webpack --port 20128","test":"npm --prefix tests test","build":"NODE_ENV=production next build --webpack && node ./scripts/ensure-middleware-manifest.js","start":"NODE_ENV=production node ./scripts/start.js","dev:bun":"bun --bun next dev --webpack --port 20128","build:bun":"NODE_ENV=production bun --bun next build --webpack && node ./scripts/ensure-middleware-manifest.js","start:bun":"NODE_ENV=production bun --bun ./scripts/start.js"},"_npmUser":{"name":"hijilab","email":"hijilab@hijitoko.com"},"repository":{"url":"git+https://github.com/rickicode/9router.git","type":"git"},"_npmVersion":"11.12.1","description":"9Router Plus - Enhanced AI Router","directories":{},"_nodeVersion":"24.15.0","dependencies":{"fs":"^0.0.1-security","ora":"^9.1.0","jose":"^6.1.3","next":"^16.1.6","open":"^11.0.0","uuid":"^13.0.0","lowdb":"^7.0.1","react":"19.2.4","marked":"^18.0.1","sql.js":"^1.14.1","undici":"^7.19.2","confbox":"^0.2.4","express":"^5.2.1","zustand":"^5.0.10","bcryptjs":"^3.0.3","react-is":"^16.13.1","recharts":"^3.7.0","react-dom":"19.2.4","node-forge":"^1.3.3","selfsigned":"^5.5.0","react-icons":"^5.6.0","got-scraping":"^4.2.1","lucide-react":"^1.14.0","@xyflow/react":"^12.10.1","monaco-editor":"^0.55.1","better-sqlite3":"^12.6.2","node-machine-id":"^1.1.12","socks-proxy-agent":"^8.0.5","@monaco-editor/react":"^4.7.0","http-proxy-middleware":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9","postcss":"^8.5.6","tailwindcss":"^4","eslint-config-next":"16.1.6","@tailwindcss/postcss":"^4.1.18"},"_npmOperationalInternal":{"tmp":"tmp/9router-plus_0.5.0_1778297829120_0.7687581033988291","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"9router-plus","version":"0.5.1","keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"author":{"name":"rickicode"},"license":"MIT","_id":"9router-plus@0.5.1","maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"homepage":"https://github.com/rickicode/9router#readme","bugs":{"url":"https://github.com/rickicode/9router/issues"},"bin":{"9router-plus":"bin/9router-plus.js"},"dist":{"shasum":"84da1d058d0e3eb1e7d0e84f761d8c11a4d9a92f","tarball":"https://registry.npmjs.org/9router-plus/-/9router-plus-0.5.1.tgz","fileCount":233,"integrity":"sha512-cKSHLfa9O5OD81BRznIBRDUJgHJ0/XX4+CT8gAaHSSjYmyBShznDn3NBZGyeAtXrBVFCdLzzDekNOAfixIMfRA==","signatures":[{"sig":"MEUCIDMfphb2JrzuRRkgiH53itvkerYSthuVWuCxft1eMxw3AiEAi4lHxX4FFS2mbOjl8n1KYFm56wnzAxWX6Jd3Zi4CwuM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2023200},"gitHead":"f2e5f3f95903f6734580fc368245bb1f7f31da3e","private":false,"scripts":{"dev":"next dev --hostname 127.0.0.1 --webpack --port 20128","test":"npm --prefix tests test","build":"NODE_ENV=production next build --webpack && node ./scripts/ensure-middleware-manifest.js","start":"NODE_ENV=production node ./scripts/start.js","dev:bun":"bun --bun next dev --webpack --port 20128","build:bun":"NODE_ENV=production bun --bun next build --webpack && node ./scripts/ensure-middleware-manifest.js","start:bun":"NODE_ENV=production bun --bun ./scripts/start.js"},"_npmUser":{"name":"hijilab","email":"hijilab@hijitoko.com"},"repository":{"url":"git+https://github.com/rickicode/9router.git","type":"git"},"_npmVersion":"11.12.1","description":"9Router Plus - Enhanced AI Router","directories":{},"_nodeVersion":"24.15.0","dependencies":{"fs":"^0.0.1-security","ora":"^9.1.0","jose":"^6.1.3","next":"^16.1.6","open":"^11.0.0","uuid":"^13.0.0","lowdb":"^7.0.1","react":"19.2.4","marked":"^18.0.1","sql.js":"^1.14.1","undici":"^7.19.2","confbox":"^0.2.4","express":"^5.2.1","zustand":"^5.0.10","bcryptjs":"^3.0.3","react-is":"^16.13.1","recharts":"^3.7.0","react-dom":"19.2.4","node-forge":"^1.3.3","selfsigned":"^5.5.0","react-icons":"^5.6.0","got-scraping":"^4.2.1","lucide-react":"^1.14.0","@xyflow/react":"^12.10.1","monaco-editor":"^0.55.1","better-sqlite3":"^12.6.2","node-machine-id":"^1.1.12","socks-proxy-agent":"^8.0.5","@monaco-editor/react":"^4.7.0","http-proxy-middleware":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9","postcss":"^8.5.6","tailwindcss":"^4","eslint-config-next":"16.1.6","@tailwindcss/postcss":"^4.1.18"},"_npmOperationalInternal":{"tmp":"tmp/9router-plus_0.5.1_1778298200519_0.5029811022242214","host":"s3://npm-registry-packages-npm-production"}},"0.5.2":{"name":"9router-plus","version":"0.5.2","keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"author":{"name":"rickicode"},"license":"MIT","_id":"9router-plus@0.5.2","maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"homepage":"https://github.com/rickicode/9router#readme","bugs":{"url":"https://github.com/rickicode/9router/issues"},"bin":{"9router-plus":"bin/9router-plus.js"},"dist":{"shasum":"0c7f227057e06ec26776826b2b12fb12998477bb","tarball":"https://registry.npmjs.org/9router-plus/-/9router-plus-0.5.2.tgz","fileCount":3841,"integrity":"sha512-dkSwkBEfHyi4O2L0YcF8aY7Ya56/R1g3x9+U3YRnt5eaS411cK3kjv/Y5soFTQrlTd0JpJRu2awRscK63wMc2Q==","signatures":[{"sig":"MEUCIEpA7PopqHa+Q1iIFOLQNfV5Z38jTobJHCI0BGU1lkhgAiEAigZaQL6NTktD/bNsm+q4f3nysLUMG1B/aavFv95wjMY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67239513},"gitHead":"080e4b9c4733c1c91ca5605fa7659fbc0b131d07","private":false,"scripts":{"dev":"next dev --hostname 127.0.0.1 --webpack --port 7127","test":"npm --prefix tests test","build":"NODE_ENV=production next build --webpack && node ./scripts/ensure-middleware-manifest.js","start":"NODE_ENV=production node ./scripts/start.js","dev:bun":"bun --bun next dev --webpack --port 7127","prepack":"npm run build","build:bun":"NODE_ENV=production bun --bun next build --webpack && node ./scripts/ensure-middleware-manifest.js","start:bun":"NODE_ENV=production bun --bun ./scripts/start.js"},"_npmUser":{"name":"hijilab","email":"hijilab@hijitoko.com"},"repository":{"url":"git+https://github.com/rickicode/9router.git","type":"git"},"_npmVersion":"11.12.1","description":"9Router Plus - Enhanced AI Router","directories":{},"_nodeVersion":"24.15.0","dependencies":{"fs":"^0.0.1-security","ora":"^9.1.0","jose":"^6.1.3","next":"^16.1.6","open":"^11.0.0","uuid":"^13.0.0","lowdb":"^7.0.1","react":"19.2.4","marked":"^18.0.1","sql.js":"^1.14.1","undici":"^7.19.2","confbox":"^0.2.4","express":"^5.2.1","zustand":"^5.0.10","bcryptjs":"^3.0.3","react-is":"^16.13.1","recharts":"^3.7.0","react-dom":"19.2.4","node-forge":"^1.3.3","selfsigned":"^5.5.0","react-icons":"^5.6.0","got-scraping":"^4.2.1","lucide-react":"^1.14.0","@xyflow/react":"^12.10.1","monaco-editor":"^0.55.1","better-sqlite3":"^12.6.2","node-machine-id":"^1.1.12","socks-proxy-agent":"^8.0.5","@monaco-editor/react":"^4.7.0","http-proxy-middleware":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9","postcss":"^8.5.6","tailwindcss":"^4","eslint-config-next":"16.1.6","@tailwindcss/postcss":"^4.1.18"},"_npmOperationalInternal":{"tmp":"tmp/9router-plus_0.5.2_1778308338651_0.7114046124916187","host":"s3://npm-registry-packages-npm-production"}},"0.5.3":{"name":"9router-plus","version":"0.5.3","keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"author":{"name":"rickicode"},"license":"MIT","_id":"9router-plus@0.5.3","maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"homepage":"https://github.com/rickicode/9router#readme","bugs":{"url":"https://github.com/rickicode/9router/issues"},"bin":{"9router-plus":"bin/9router-plus.js"},"dist":{"shasum":"cfe334eeb9728fb51e2157fd48c67bb1b8c069be","tarball":"https://registry.npmjs.org/9router-plus/-/9router-plus-0.5.3.tgz","fileCount":3841,"integrity":"sha512-5HVeawUW91ftU8OoOCawtMVoGRECqq7UT+fvw+TmnyjCr2k1f24s/CBsCom2el09AErtWb0rMYplDu5D+4TW/w==","signatures":[{"sig":"MEQCIEc/w1qhk6x2LmGecIAu9lhe5Td1ugLo7ht0FZdpFGrZAiA+MG0bOc5HKDfrikd2+iB1bEz48CxvWVyY4oKHG5993w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67239571},"gitHead":"080e4b9c4733c1c91ca5605fa7659fbc0b131d07","private":false,"scripts":{"dev":"next dev --hostname 127.0.0.1 --webpack --port 7127","test":"npm --prefix tests test","build":"NODE_ENV=production next build --webpack && node ./scripts/ensure-middleware-manifest.js","start":"NODE_ENV=production node ./scripts/start.js","dev:bun":"bun --bun next dev --webpack --port 7127","prepack":"npm run build","build:bun":"NODE_ENV=production bun --bun next build --webpack && node ./scripts/ensure-middleware-manifest.js","start:bun":"NODE_ENV=production bun --bun ./scripts/start.js"},"_npmUser":{"name":"hijilab","email":"hijilab@hijitoko.com"},"repository":{"url":"git+https://github.com/rickicode/9router.git","type":"git"},"_npmVersion":"11.12.1","description":"9Router Plus - Enhanced AI Router","directories":{},"_nodeVersion":"24.15.0","dependencies":{"fs":"^0.0.1-security","ora":"^9.1.0","jose":"^6.1.3","next":"^16.1.6","open":"^11.0.0","uuid":"^13.0.0","lowdb":"^7.0.1","react":"19.2.4","marked":"^18.0.1","sql.js":"^1.14.1","undici":"^7.19.2","confbox":"^0.2.4","express":"^5.2.1","zustand":"^5.0.10","bcryptjs":"^3.0.3","react-is":"^16.13.1","recharts":"^3.7.0","react-dom":"19.2.4","node-forge":"^1.3.3","selfsigned":"^5.5.0","react-icons":"^5.6.0","got-scraping":"^4.2.1","lucide-react":"^1.14.0","@xyflow/react":"^12.10.1","monaco-editor":"^0.55.1","better-sqlite3":"^12.6.2","node-machine-id":"^1.1.12","socks-proxy-agent":"^8.0.5","@monaco-editor/react":"^4.7.0","http-proxy-middleware":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9","postcss":"^8.5.6","tailwindcss":"^4","eslint-config-next":"16.1.6","@tailwindcss/postcss":"^4.1.18"},"_npmOperationalInternal":{"tmp":"tmp/9router-plus_0.5.3_1778309444345_0.24058795302259095","host":"s3://npm-registry-packages-npm-production"}},"0.5.4":{"name":"9router-plus","version":"0.5.4","keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"author":{"name":"rickicode"},"license":"MIT","_id":"9router-plus@0.5.4","maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"homepage":"https://github.com/rickicode/9router#readme","bugs":{"url":"https://github.com/rickicode/9router/issues"},"bin":{"9router-plus":"bin/9router-plus.js"},"dist":{"shasum":"53133ae4dfdefa75df3a054aea521a147f1c5253","tarball":"https://registry.npmjs.org/9router-plus/-/9router-plus-0.5.4.tgz","fileCount":4047,"integrity":"sha512-Gar1+Z4G1vAofR8tf6HLgxpEZsEaboooShEUu0vY8AVuK3ecWDdUtYxyC4P4jffzz7hQqJwewCZwtK9syi42iw==","signatures":[{"sig":"MEUCIFcdn4wnyyv1KGYJF61LdvrDMNNTm6UaJDmMJHMf0B1BAiEA80lGXPV3wBjnsPSRq/fdr2jmwpAms9vpvT+u9pbKXeo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69463808},"gitHead":"2226fce00dd445e77fbf649d7b9bc221f4bfabc3","private":false,"scripts":{"dev":"next dev --hostname 127.0.0.1 --webpack --port 7127","lint":"eslint .","test":"npm --prefix tests test","build":"NODE_ENV=production next build --webpack && node ./scripts/ensure-middleware-manifest.js","start":"NODE_ENV=production node ./scripts/start.js","dev:bun":"bun --bun next dev --webpack --port 7127","prepack":"npm run build","build:bun":"NODE_ENV=production bun --bun next build --webpack && node ./scripts/ensure-middleware-manifest.js","start:bun":"NODE_ENV=production bun --bun ./scripts/start.js"},"_npmUser":{"name":"hijilab","email":"hijilab@hijitoko.com"},"repository":{"url":"git+https://github.com/rickicode/9router.git","type":"git"},"_npmVersion":"11.12.1","description":"9Router Plus - Enhanced AI Router","directories":{},"_nodeVersion":"24.15.0","dependencies":{"fs":"^0.0.1-security","ora":"^9.1.0","jose":"^6.1.3","next":"^16.1.6","open":"^11.0.0","uuid":"^13.0.0","lowdb":"^7.0.1","react":"19.2.4","marked":"^18.0.1","sql.js":"^1.14.1","undici":"^7.19.2","confbox":"^0.2.4","express":"^5.2.1","zustand":"^5.0.10","bcryptjs":"^3.0.3","react-is":"^16.13.1","recharts":"^3.7.0","react-dom":"19.2.4","node-forge":"^1.3.3","selfsigned":"^5.5.0","react-icons":"^5.6.0","got-scraping":"^4.2.1","lucide-react":"^1.14.0","@xyflow/react":"^12.10.1","monaco-editor":"^0.55.1","better-sqlite3":"^12.6.2","node-machine-id":"^1.1.12","socks-proxy-agent":"^8.0.5","@monaco-editor/react":"^4.7.0","http-proxy-middleware":"^3.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9","postcss":"^8.5.6","tailwindcss":"^4","eslint-config-next":"16.1.6","@tailwindcss/postcss":"^4.1.18"},"_npmOperationalInternal":{"tmp":"tmp/9router-plus_0.5.4_1778359301830_0.8212753993408557","host":"s3://npm-registry-packages-npm-production"}},"0.5.5":{"name":"9router-plus","version":"0.5.5","description":"9Router Plus - Enhanced AI Router","private":false,"bin":{"9router-plus":"bin/9router-plus.js","mcp-server":"bin/mcp-server-launcher.js"},"scripts":{"dev":"next dev --hostname 127.0.0.1 --webpack --port 7127","build":"NODE_ENV=production next build --webpack && node ./scripts/ensure-middleware-manifest.js","start":"NODE_ENV=production node ./scripts/start.js","lint":"eslint .","test":"npm --prefix tests test","dev:bun":"bun --bun next dev --webpack --port 7127","build:bun":"NODE_ENV=production bun --bun next build --webpack && node ./scripts/ensure-middleware-manifest.js","start:bun":"NODE_ENV=production bun --bun ./scripts/start.js","prepack":"npm run build"},"dependencies":{"@monaco-editor/react":"^4.7.0","@xyflow/react":"^12.10.1","bcryptjs":"^3.0.3","better-sqlite3":"^12.6.2","confbox":"^0.2.4","express":"^5.2.1","fs":"^0.0.1-security","got-scraping":"^4.2.1","http-proxy-middleware":"^3.0.5","jose":"^6.1.3","lowdb":"^7.0.1","lucide-react":"^1.14.0","marked":"^18.0.1","monaco-editor":"^0.55.1","next":"^16.1.6","node-forge":"^1.3.3","node-machine-id":"^1.1.12","open":"^11.0.0","ora":"^9.1.0","react":"19.2.4","react-dom":"19.2.4","react-icons":"^5.6.0","react-is":"^16.13.1","recharts":"^3.7.0","selfsigned":"^5.5.0","socks-proxy-agent":"^8.0.5","sql.js":"^1.14.1","undici":"^7.19.2","uuid":"^13.0.0","zustand":"^5.0.10"},"devDependencies":{"@tailwindcss/postcss":"^4.1.18","eslint":"^9","eslint-config-next":"16.1.6","postcss":"^8.5.6","tailwindcss":"^4"},"repository":{"type":"git","url":"git+https://github.com/rickicode/9router.git"},"keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"author":{"name":"rickicode"},"license":"MIT","homepage":"https://github.com/rickicode/9router#readme","publishConfig":{"access":"public"},"gitHead":"941e8bee3c0ec67bee929f11292cea2a2c689ffe","_id":"9router-plus@0.5.5","bugs":{"url":"https://github.com/rickicode/9router/issues"},"_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-zo+zWrPDoNcnnma21lX2HSWmYqMB5xQll2wCsluJOO6Xq7XHXtEEfHEL5/XSdIQwHEa0qHcR1TG0WB8eK0KVqA==","shasum":"8f7ad70f20e0468729783c4d075254d44dee2282","tarball":"https://registry.npmjs.org/9router-plus/-/9router-plus-0.5.5.tgz","fileCount":4188,"unpackedSize":70737402,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBoQTslq7/OWdX+rtFPTP3ttF/Fx/T3BaHyviSsVSts6AiEArO2eWlL33L56UGWZugYEc9Rd+TCptbGsnfALM9YEOJY="}]},"_npmUser":{"name":"hijilab","email":"hijilab@hijitoko.com"},"directories":{},"maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/9router-plus_0.5.5_1778656567081_0.20807264287742777"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-09T03:37:09.008Z","modified":"2026-05-13T07:16:07.993Z","0.5.0":"2026-05-09T03:37:09.294Z","0.5.1":"2026-05-09T03:43:20.790Z","0.5.2":"2026-05-09T06:32:19.355Z","0.5.3":"2026-05-09T06:50:45.102Z","0.5.4":"2026-05-09T20:41:42.490Z","0.5.5":"2026-05-13T07:16:07.869Z"},"bugs":{"url":"https://github.com/rickicode/9router/issues"},"author":{"name":"rickicode"},"license":"MIT","homepage":"https://github.com/rickicode/9router#readme","keywords":["ai-router","llm-proxy","openai","claude","gemini","smart-fallback","rate-limiting"],"repository":{"type":"git","url":"git+https://github.com/rickicode/9router.git"},"description":"9Router Plus - Enhanced AI Router","maintainers":[{"name":"hijilab","email":"hijilab@hijitoko.com"}],"readme":"
\n \"9Router\n \n # 9Router Plus - Enhanced AI Router\n \n **Never stop coding. Auto-route to FREE & cheap AI models with smart fallback.**\n \n **Connect All AI Code Tools (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) to 40+ AI Providers & 100+ Models.**\n \n [![License](https://img.shields.io/npm/l/9router.svg)](https://github.com/rickicode/9router/blob/main/LICENSE)\n [![Version](https://img.shields.io/badge/version-0.5.4-blue.svg)](https://github.com/rickicode/9router)\n \n [šŸš€ Quick Start](#-quick-start) ā€¢ [šŸ’” Features](#-key-features) ā€¢ [šŸ“– Setup](#-setup-guide) ā€¢ [šŸ”„ vs 9Router](#-9router-plus-vs-9router)\n\n **Based on [9Router](https://github.com/decolua/9router) by decolua**\n
\n\n---\n\n## šŸ”„ 9Router Plus vs 9Router\n\n| Feature | 9Router | 9Router Plus |\n|---------|---------|--------------|\n| **Core Routing** | āœ… Smart fallback | āœ… Smart fallback |\n| **Providers** | 40+ providers | 40+ providers |\n| **Translation Layer** | OpenAI ā†” Claude | āœ… OpenAI ā†” Claude ā†” Gemini |\n| **Morph Proxy** | āŒ | āœ… Full `morphllm` namespace (apply, compact, embeddings, rerank, warpgrep) |\n| **Morph Key Rotation** | āŒ | āœ… Round-robin key failover + auto-exhausted detection |\n| **Morph Usage Dashboard** | āŒ | āœ… Credits tracking, capability breakdown, auto-compact stats |\n| **Tab-Based UI** | āŒ | āœ… Main/Cloud tabs |\n| **Security Hardening** | Basic | āœ… 12 critical bug fixes + SSRF protection |\n| **Real-Time Monitoring** | Basic | āœ… Live status + logs viewer |\n| **Auto-Restart** | āŒ | āœ… Config change detection |\n| **Responsive Design** | Basic | āœ… Mobile/Tablet/Desktop optimized |\n\n**Key Enhancements:**\n- šŸ”„ **Enhanced Translation** - Full OpenAI ā†” Claude ā†” Gemini format support\n- šŸŽØ **Modern UI** - Tab-based interface with glassmorphism design\n- šŸ”’ **Security First** - Fixed 12 critical bugs, added SSRF protection\n- šŸ“Š **Real-Time Monitoring** - Live status updates and log streaming\n- šŸ“± **Responsive** - Optimized for all screen sizes\n- šŸ”€ **Morph Proxy** - Built-in proxy ke Morph API (`api.morphllm.com`) dengan namespace `morphllm`, round-robin key rotation, usage tracking, dan dedicated dashboard\n\n---\n\n## šŸ¤” Why 9Router Plus?\n\n**Stop wasting money and hitting limits:**\n\n- āŒ Subscription quota expires unused every month\n- āŒ Rate limits stop you mid-coding\n- āŒ Expensive APIs ($20-50/month per provider)\n- āŒ Manual switching between providers\n\n**9Router Plus solves this:**\n\n- āœ… **Maximize subscriptions** - Track quota, use every bit before reset\n- āœ… **Auto fallback** - Subscription ā†’ Cheap ā†’ Free, zero downtime\n- āœ… **Multi-account** - Round-robin between accounts per provider\n- āœ… **Universal** - Works with Claude Code, Codex, Gemini CLI, Cursor, Cline, any CLI tool\n- āœ… **Enhanced Security** - 12 critical bug fixes + SSRF protection + audit logging\n\n---\n\n## šŸ”„ How It Works\n\n```\nā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”\nā”‚ Your CLI ā”‚ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)\nā”‚ Tool ā”‚\nā””ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”˜\n ā”‚ http://localhost:20128/v1\n ā†“\nā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”\nā”‚ 9Router Plus (Smart Router) ā”‚\nā”‚ ā€¢ Format translation (OpenAI ā†” Claude ā†” Gemini) ā”‚\nā”‚ ā€¢ Quota tracking ā”‚\nā”‚ ā€¢ Auto token refresh ā”‚\nā””ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜\n ā”‚\n ā”œā”€ā†’ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI\n ā”‚ ā†“ quota exhausted\n ā”œā”€ā†’ [Tier 2: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)\n ā”‚ ā†“ budget limit\n ā””ā”€ā†’ [Tier 3: FREE] iFlow, Qwen, Kiro (unlimited)\n\nResult: Never stop coding, minimal cost\n```\n\n---\n\n## āš” Quick Start\n\n**1. Run directly with npx**\n\n```bash\nnpx 9router-plus\n```\n\nOr install globally:\n\n```bash\nnpm install -g 9router-plus\n9router-plus\n```\n\nOr install locally in a project:\n\n```bash\nmkdir 9router-plus-app\ncd 9router-plus-app\nnpm init -y\nnpm install 9router-plus\nnpx 9router-plus\n```\n\n**2. Start 9Router Plus**\n\nYou can also run the underlying script directly if needed:\n\n```bash\nPORT=20128 HOSTNAME=0.0.0.0 node ./node_modules/9router-plus/scripts/start.js\n```\n\nOpen:\n- Dashboard: `http://localhost:20128/dashboard`\n- OpenAI-compatible API: `http://localhost:20128/v1`\n\nNotes:\n- This package is published on npm and now exposes the `9router-plus` CLI for both `npx` and global install.\n- If you need custom environment variables, create a `.env` in your app directory before starting.\n- Default port is `20128`; override with `PORT=3000`, `9router-plus --port 3000`, or `9router-plus -p 3000`.\n- Startup now prints the exact Dashboard and API URLs, plus the runtime mode being used.\n\n**3. Connect a FREE provider (no signup needed):**\n\nDashboard ā†’ Providers ā†’ Connect **Claude Code** or **Antigravity** ā†’ OAuth login ā†’ Done!\n\n**3. Use in your CLI tool:**\n\n```\nClaude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:\n Endpoint: http://localhost:20128/v1\n API Key: [copy from dashboard]\n Model: if/kimi-k2-thinking\n```\n\n**That's it!** Start coding with FREE AI models.\n\nStart command examples:\n\n```bash\nnpx 9router-plus\n# or\n9router-plus\n# or\n9router-plus --port 3000\n# or\nPORT=20128 HOSTNAME=0.0.0.0 node ./node_modules/9router-plus/scripts/start.js\n```\n\nIf port `20128` is already in use, 9Router Plus will print a clear error showing:\n- which port is blocked\n- the Dashboard and API URLs that would have used that port\n- commands to free the port\n- how to rerun on another port with `--port 3000`\n\nIf the package cannot find a runnable runtime, 9Router Plus will also explain whether the standalone build is missing or whether you are starting it from the wrong directory.\n\nIf you want to free the default port manually:\n\n```bash\nfuser -k 20128/tcp\n# fallback:\nlsof -ti :20128 | xargs -r kill -9\n```\n\nDefault URLs:\n- Dashboard: `http://localhost:20128/dashboard`\n- OpenAI-compatible API: `http://localhost:20128/v1`\n\n---\n\n## šŸŽ„ Video Tutorial\n\n
\n \n### šŸ“ŗ Complete Setup Guide - 9Router + Claude Code FREE\n \n[![9Router + Claude Code Setup](https://img.youtube.com/vi/raEyZPg5xE0/maxresdefault.jpg)](https://www.youtube.com/watch?v=raEyZPg5xE0)\n\n**šŸŽ¬ Watch the complete step-by-step tutorial:**\n- āœ… 9Router installation & setup\n- āœ… FREE Claude Sonnet 4.5 configuration\n- āœ… Claude Code integration\n- āœ… Live coding demonstration\n\n**ā±ļø Duration:** 20 minutes | **šŸ‘„ By:** Developer Community\n\n[ā–¶ļø Watch on YouTube](https://www.youtube.com/watch?v=o3qYCyjrFYg)\n\n
\n\n---\n\n## šŸ› ļø Supported CLI Tools\n\n9Router works seamlessly with all major AI coding tools:\n\n
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n \"Claude
\n Claude-Code\n 		\n \"OpenClaw\"/
\n OpenClaw\n 		\n \"Codex\"/
\n Codex\n 		\n \"OpenCode\"/
\n OpenCode\n 		\n \"Cursor\"/
\n Cursor\n 		\n \"Antigravity\"/
\n Antigravity\n
\n \"Cline\"/
\n Cline\n 		\n \"Continue\"/
\n Continue\n 		\n \"Droid\"/
\n Droid\n 		\n \"Roo\"/
\n Roo\n 		\n \"Copilot\"/
\n Copilot\n 		\n \"Kilo
\n Kilo Code\n
\n
\n\n---\n\n## šŸŒ Supported Providers\n\n### šŸ” OAuth Providers\n\n
\n \n \n \n \n \n \n \n \n
\n \"Claude
\n Claude-Code\n 		\n \"Antigravity\"/
\n Antigravity\n 		\n \"Codex\"/
\n Codex\n 		\n \"GitHub\"/
\n GitHub\n 		\n \"Cursor\"/
\n Cursor\n
\n
\n\n### šŸ†“ Free Providers\n\n
\n \n \n \n \n \n \n \n
\n \"iFlow\"/
\n iFlow AI
\n 8+ models ā€¢ Unlimited\n 		\n \"Qwen\"/
\n Qwen Code
\n 3+ models ā€¢ Unlimited\n 		\n \"Gemini
\n Gemini CLI
\n 180K/month FREE\n 		\n \"Kiro\"/
\n Kiro AI
\n Claude ā€¢ Unlimited\n
\n
\n\n### šŸ”‘ API Key Providers (40+)\n\n
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n \"OpenRouter\"/
\n OpenRouter\n 		\n \"GLM\"/
\n GLM\n 		\n \"Kimi\"/
\n Kimi\n 		\n \"MiniMax\"/
\n MiniMax\n 		\n \"OpenAI\"/
\n OpenAI\n 		\n \"Anthropic\"/
\n Anthropic\n
\n \"Gemini\"/
\n Gemini\n 		\n \"DeepSeek\"/
\n DeepSeek\n 		\n \"Groq\"/
\n Groq\n 		\n \"xAI\"/
\n xAI\n 		\n \"Mistral\"/
\n Mistral\n 		\n \"Perplexity\"/
\n Perplexity\n
\n \"Together\"/
\n Together AI\n 		\n \"Fireworks\"/
\n Fireworks\n 		\n \"Cerebras\"/
\n Cerebras\n 		\n \"Cohere\"/
\n Cohere\n 		\n \"NVIDIA\"/
\n NVIDIA\n 		\n \"SiliconFlow\"/
\n SiliconFlow\n
\n

...and 20+ more providers including Nebius, Chutes, Hyperbolic, and custom OpenAI/Anthropic compatible endpoints

\n
\n\n---\n\n## šŸ’” Key Features\n\n| Feature | What It Does | Why It Matters |\n|---------|--------------|----------------|\n| šŸŽÆ **Smart 3-Tier Fallback** | Auto-route: Subscription ā†’ Cheap ā†’ Free | Never stop coding, zero downtime |\n| šŸ“Š **Real-Time Quota Tracking** | Live token count + reset countdown | Maximize subscription value |\n| šŸ”„ **Format Translation** | OpenAI ā†” Claude ā†” Gemini seamless | Works with any CLI tool |\n| šŸ‘„ **Multi-Account Support** | Multiple accounts per provider | Load balancing + redundancy |\n| šŸ”„ **Auto Token Refresh** | OAuth tokens refresh automatically | No manual re-login needed |\n| šŸŽØ **Custom Combos** | Create unlimited model combinations | Tailor fallback to your needs |\n| šŸ“ **Request Logging** | Debug mode with full request/response logs | Troubleshoot issues easily |\n| šŸ’¾ **Cloud Sync** | Sync config across devices | Same setup everywhere |\n| šŸ“Š **Usage Analytics** | Track tokens, cost, trends over time | Optimize spending |\n| šŸŒ **Deploy Anywhere** | Localhost, VPS, Docker, Cloudflare Workers | Flexible deployment options |\n\n
\nšŸ“– Feature Details\n\n### šŸŽÆ Smart 3-Tier Fallback\n\nCreate combos with automatic fallback:\n\n```\nCombo: \"my-coding-stack\"\n 1. cc/claude-opus-4-6 (your subscription)\n 2. glm/glm-4.7 (cheap backup, $0.6/1M)\n 3. if/kimi-k2-thinking (free fallback)\n\nā†’ Auto switches when quota runs out or errors occur\n```\n\n### šŸ“Š Real-Time Quota Tracking\n\n- Token consumption per provider\n- Reset countdown (5-hour, daily, weekly)\n- Cost estimation for paid tiers\n- Monthly spending reports\n\n### šŸ”„ Format Translation\n\nSeamless translation between formats:\n- **OpenAI** ā†” **Claude** ā†” **Gemini** ā†” **OpenAI Responses**\n- Your CLI tool sends OpenAI format ā†’ 9Router translates ā†’ Provider receives native format\n- Works with any tool that supports custom OpenAI endpoints\n\n### šŸ‘„ Multi-Account Support\n\n- Add multiple accounts per provider\n- Auto round-robin or priority-based routing\n- Fallback to next account when one hits quota\n\n### šŸ”„ Auto Token Refresh\n\n- OAuth tokens automatically refresh before expiration\n- No manual re-authentication needed\n- Seamless experience across all providers\n\n### šŸŽØ Custom Combos\n\n- Create unlimited model combinations\n- Mix subscription, cheap, and free tiers\n- Name your combos for easy access\n- Share combos across devices with Cloud Sync\n\n### šŸ“ Request Logging\n\n- Enable debug mode for full request/response logs\n- Track API calls, headers, and payloads\n- Troubleshoot integration issues\n- Export logs for analysis\n\n### šŸ’¾ Cloud Sync\n\n- Sync providers, combos, and settings across devices\n- Automatic background sync\n- Secure encrypted storage\n- Access your setup from anywhere\n\n#### Cloud Runtime Notes\n\n- Prefer server-side cloud variables in production:\n - `BASE_URL` (internal callback URL used by sync scheduler)\n - `CLOUD_URL` (cloud sync endpoint base)\n- `NEXT_PUBLIC_BASE_URL` and `NEXT_PUBLIC_CLOUD_URL` are still supported for compatibility/UI, but server runtime now prioritizes `BASE_URL`/`CLOUD_URL`.\n- Cloud sync requests now use timeout + fail-fast behavior to avoid UI hanging when cloud DNS/network is unavailable.\n\n### šŸ“Š Usage Analytics\n\n- Track token usage per provider and model\n- Cost estimation and spending trends\n- Monthly reports and insights\n- Optimize your AI spending\n\n> **šŸ’” IMPORTANT - Understanding Dashboard Costs:**\n> \n> The \"cost\" displayed in Usage Analytics is **for tracking and comparison purposes only**. \n> 9Router itself **never charges** you anything. You only pay providers directly (if using paid services).\n> \n> **Example:** If your dashboard shows \"$290 total cost\" while using iFlow models, this represents \n> what you would have paid using paid APIs directly. Your actual cost = **$0** (iFlow is free unlimited).\n> \n> Think of it as a \"savings tracker\" showing how much you're saving by using free models or \n> routing through 9Router!\n\n### šŸŒ Deploy Anywhere\n\n- šŸ’» **Localhost** - Default, works offline\n- ā˜ļø **VPS/Cloud** - Share across devices\n- šŸ³ **Docker** - One-command deployment\n- šŸš€ **Cloudflare Workers** - Global edge network\n\n
\n\n---\n\n## šŸ’° Pricing at a Glance\n\n| Tier | Provider | Cost | Quota Reset | Best For |\n|------|----------|------|-------------|----------|\n| **šŸ’³ SUBSCRIPTION** | Claude Code (Pro) | $20/mo | 5h + weekly | Already subscribed |\n| | Codex (Plus/Pro) | $20-200/mo | 5h + weekly | OpenAI users |\n| | Gemini CLI | **FREE** | 180K/mo + 1K/day | Everyone! |\n| | GitHub Copilot | $10-19/mo | Monthly | GitHub users |\n| **šŸ’° CHEAP** | GLM-4.7 | $0.6/1M | Daily 10AM | Budget backup |\n| | MiniMax M2.1 | $0.2/1M | 5-hour rolling | Cheapest option |\n| | Kimi K2 | $9/mo flat | 10M tokens/mo | Predictable cost |\n| **šŸ†“ FREE** | iFlow | $0 | Unlimited | 8 models free |\n| | Qwen | $0 | Unlimited | 3 models free |\n| | Kiro | $0 | Unlimited | Claude free |\n\n**šŸ’” Pro Tip:** Start with Gemini CLI (180K free/month) + iFlow (unlimited free) combo = $0 cost!\n\n---\n\n### šŸ“Š Understanding 9Router Costs & Billing\n\n**9Router Billing Reality:**\n\nāœ… **9Router software = FREE forever** (open source, never charges) \nāœ… **Dashboard \"costs\" = Display/tracking only** (not actual bills) \nāœ… **You pay providers directly** (subscriptions or API fees) \nāœ… **FREE providers stay FREE** (iFlow, Kiro, Qwen = $0 unlimited) \nāŒ **9Router never sends invoices** or charges your card\n\n**How Cost Display Works:**\n\nThe dashboard shows **estimated costs** as if you were using paid APIs directly. This is **not billing** - it's a comparison tool to show your savings.\n\n**Example Scenario:**\n```\nDashboard Display:\nā€¢ Total Requests: 1,662\nā€¢ Total Tokens: 47M\nā€¢ Display Cost: $290\n\nReality Check:\nā€¢ Provider: iFlow (FREE unlimited)\nā€¢ Actual Payment: $0.00\nā€¢ What $290 Means: Amount you SAVED by using free models!\n```\n\n**Payment Rules:**\n- **Subscription providers** (Claude Code, Codex): Pay them directly via their websites\n- **Cheap providers** (GLM, MiniMax): Pay them directly, 9Router just routes\n- **FREE providers** (iFlow, Kiro, Qwen): Genuinely free forever, no hidden charges\n- **9Router**: Never charges anything, ever\n\n---\n\n## šŸŽÆ Use Cases\n\n### Case 1: \"I have Claude Pro subscription\"\n\n**Problem:** Quota expires unused, rate limits during heavy coding\n\n**Solution:**\n```\nCombo: \"maximize-claude\"\n 1. cc/claude-opus-4-6 (use subscription fully)\n 2. glm/glm-4.7 (cheap backup when quota out)\n 3. if/kimi-k2-thinking (free emergency fallback)\n\nMonthly cost: $20 (subscription) + ~$5 (backup) = $25 total\nvs. $20 + hitting limits = frustration\n```\n\n### Case 2: \"I want zero cost\"\n\n**Problem:** Can't afford subscriptions, need reliable AI coding\n\n**Solution:**\n```\nCombo: \"free-forever\"\n 1. gc/gemini-3-flash (180K free/month)\n 2. if/kimi-k2-thinking (unlimited free)\n 3. qw/qwen3-coder-plus (unlimited free)\n\nMonthly cost: $0\nQuality: Production-ready models\n```\n\n### Case 3: \"I need 24/7 coding, no interruptions\"\n\n**Problem:** Deadlines, can't afford downtime\n\n**Solution:**\n```\nCombo: \"always-on\"\n 1. cc/claude-opus-4-6 (best quality)\n 2. cx/gpt-5.2-codex (second subscription)\n 3. glm/glm-4.7 (cheap, resets daily)\n 4. minimax/MiniMax-M2.1 (cheapest, 5h reset)\n 5. if/kimi-k2-thinking (free unlimited)\n\nResult: 5 layers of fallback = zero downtime\nMonthly cost: $20-200 (subscriptions) + $10-20 (backup)\n```\n\n### Case 4: \"I want FREE AI in OpenClaw\"\n\n**Problem:** Need AI assistant in messaging apps (WhatsApp, Telegram, Slack...), completely free\n\n**Solution:**\n```\nCombo: \"openclaw-free\"\n 1. if/glm-4.7 (unlimited free)\n 2. if/minimax-m2.1 (unlimited free)\n 3. if/kimi-k2-thinking (unlimited free)\n\nMonthly cost: $0\nAccess via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...\n```\n\n---\n\n## ā“ Frequently Asked Questions\n\n
\nšŸ“Š Why does my dashboard show high costs?\n\nThe dashboard tracks your token usage and displays **estimated costs** as if you were using paid APIs directly. This is **not actual billing** - it's a reference to show how much you're saving by using free models or existing subscriptions through 9Router.\n\n**Example:**\n- **Dashboard shows:** \"$290 total cost\"\n- **Reality:** You're using iFlow (FREE unlimited)\n- **Your actual cost:** **$0.00**\n- **What $290 means:** Amount you **saved** by using free models instead of paid APIs!\n\nThe cost display is a \"savings tracker\" to help you understand your usage patterns and optimization opportunities.\n\n
\n\n
\nšŸ’³ Will I be charged by 9Router?\n\n**No.** 9Router is free, open-source software that runs on your own computer. It never charges you anything.\n\n**You only pay:**\n- āœ… **Subscription providers** (Claude Code $20/mo, Codex $20-200/mo) ā†’ Pay them directly on their websites\n- āœ… **Cheap providers** (GLM, MiniMax) ā†’ Pay them directly, 9Router just routes your requests\n- āŒ **9Router itself** ā†’ **Never charges anything, ever**\n\n9Router is a local proxy/router. It doesn't have your credit card, can't send invoices, and has no billing system. It's completely free software.\n\n
\n\n
\nšŸ†“ Are FREE providers really unlimited?\n\n**Yes!** Providers marked as FREE (iFlow, Kiro, Qwen) are genuinely unlimited with **no hidden charges**. \n\nThese are free services offered by those respective companies:\n- **iFlow**: Free unlimited access to 8+ models via OAuth\n- **Kiro**: Free unlimited Claude models via AWS Builder ID \n- **Qwen**: Free unlimited access to Qwen models via device auth\n\n9Router just routes your requests to them - there's no \"catch\" or future billing. They're truly free services, and 9Router makes them easy to use with fallback support.\n\n**Note:** Some subscription providers (Antigravity, GitHub Copilot) may have free preview periods that could become paid later, but this would be clearly announced by those providers, not 9Router.\n\n
\n\n
\nšŸ’° How do I minimize my actual AI costs?\n\n**Free-First Strategy:**\n\n1. **Start with 100% free combo:**\n ```\n 1. gc/gemini-3-flash (180K/month free from Google)\n 2. if/kimi-k2-thinking (unlimited free from iFlow)\n 3. qw/qwen3-coder-plus (unlimited free from Qwen)\n ```\n **Cost: $0/month**\n\n2. **Add cheap backup** only if you need it:\n ```\n 4. glm/glm-4.7 ($0.6/1M tokens)\n ```\n **Additional cost: Only pay for what you actually use**\n\n3. **Use subscription providers last:**\n - Only if you already have them\n - 9Router helps maximize their value through quota tracking\n\n**Result:** Most users can operate at $0/month using only free tiers!\n\n
\n\n
\nšŸ“ˆ What if my usage suddenly spikes?\n\n9Router's smart fallback prevents surprise charges:\n\n**Scenario:** You're on a coding sprint and blow through your quotas\n\n**Without 9Router:**\n- āŒ Hit rate limit ā†’ Work stops ā†’ Frustration\n- āŒ Or: Accidentally rack up huge API bills\n\n**With 9Router:**\n- āœ… Subscription hits limit ā†’ Auto-fallback to cheap tier\n- āœ… Cheap tier gets expensive ā†’ Auto-fallback to free tier\n- āœ… Never stop coding ā†’ Predictable costs\n\n**You're in control:** Set spending limits per provider in dashboard, and 9Router respects them.\n\n
\n\n---\n\n## šŸ“– Setup Guide\n\n
\nšŸ” Subscription Providers (Maximize Value)\n\n### Claude Code (Pro/Max)\n\n```bash\nDashboard ā†’ Providers ā†’ Connect Claude Code\nā†’ OAuth login ā†’ Auto token refresh\nā†’ 5-hour + weekly quota tracking\n\nModels:\n cc/claude-opus-4-6\n cc/claude-sonnet-4-5-20250929\n cc/claude-haiku-4-5-20251001\n```\n\n**Pro Tip:** Use Opus for complex tasks, Sonnet for speed. 9Router tracks quota per model!\n\n### OpenAI Codex (Plus/Pro)\n\n```bash\nDashboard ā†’ Providers ā†’ Connect Codex\nā†’ OAuth login (port 1455)\nā†’ 5-hour + weekly reset\n\nModels:\n cx/gpt-5.2-codex\n cx/gpt-5.1-codex-max\n```\n\n### Gemini CLI (FREE 180K/month!)\n\n```bash\nDashboard ā†’ Providers ā†’ Connect Gemini CLI\nā†’ Google OAuth\nā†’ 180K completions/month + 1K/day\n\nModels:\n gc/gemini-3-flash-preview\n gc/gemini-2.5-pro\n```\n\n**Best Value:** Huge free tier! Use this before paid tiers.\n\n### GitHub Copilot\n\n```bash\nDashboard ā†’ Providers ā†’ Connect GitHub\nā†’ OAuth via GitHub\nā†’ Monthly reset (1st of month)\n\nModels:\n gh/gpt-5\n gh/claude-4.5-sonnet\n gh/gemini-3-pro\n```\n\n
\n\n
\nšŸ’° Cheap Providers (Backup)\n\n### GLM-4.7 (Daily reset, $0.6/1M)\n\n1. Sign up: [Zhipu AI](https://open.bigmodel.cn/)\n2. Get API key from Coding Plan\n3. Dashboard ā†’ Add API Key:\n - Provider: `glm`\n - API Key: `your-key`\n\n**Use:** `glm/glm-4.7`\n\n**Pro Tip:** Coding Plan offers 3Ɨ quota at 1/7 cost! Reset daily 10:00 AM.\n\n### MiniMax M2.1 (5h reset, $0.20/1M)\n\n1. Sign up: [MiniMax](https://www.minimax.io/)\n2. Get API key\n3. Dashboard ā†’ Add API Key\n\n**Use:** `minimax/MiniMax-M2.1`\n\n**Pro Tip:** Cheapest option for long context (1M tokens)!\n\n### Kimi K2 ($9/month flat)\n\n1. Subscribe: [Moonshot AI](https://platform.moonshot.ai/)\n2. Get API key\n3. Dashboard ā†’ Add API Key\n\n**Use:** `kimi/kimi-latest`\n\n**Pro Tip:** Fixed $9/month for 10M tokens = $0.90/1M effective cost!\n\n
\n\n
\nšŸ†“ FREE Providers (Emergency Backup)\n\n### iFlow (8 FREE models)\n\n```bash\nDashboard ā†’ Connect iFlow\nā†’ iFlow OAuth login\nā†’ Unlimited usage\n\nModels:\n if/kimi-k2-thinking\n if/qwen3-coder-plus\n if/glm-4.7\n if/minimax-m2\n if/deepseek-r1\n```\n\n### Qwen (3 FREE models)\n\n```bash\nDashboard ā†’ Connect Qwen\nā†’ Device code authorization\nā†’ Unlimited usage\n\nModels:\n qw/qwen3-coder-plus\n qw/qwen3-coder-flash\n```\n\n### Kiro (Claude FREE)\n\n```bash\nDashboard ā†’ Connect Kiro\nā†’ AWS Builder ID, AWS IAM Identity Center, Google, GitHub\nā†’ Unlimited usage\n\nModels:\n kr/claude-sonnet-4.5\n kr/claude-haiku-4.5\n```\n\n
\n\n
\nšŸŽØ Create Combos\n\n### Example 1: Maximize Subscription ā†’ Cheap Backup\n\n```\nDashboard ā†’ Combos ā†’ Create New\n\nName: premium-coding\nModels:\n 1. cc/claude-opus-4-6 (Subscription primary)\n 2. glm/glm-4.7 (Cheap backup, $0.6/1M)\n 3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)\n\nUse in CLI: premium-coding\n\nMonthly cost example (100M tokens):\n 80M via Claude (subscription): $0 extra\n 15M via GLM: $9\n 5M via MiniMax: $1\n Total: $10 + your subscription\n```\n\n### Example 2: Free-Only (Zero Cost)\n\n```\nName: free-combo\nModels:\n 1. gc/gemini-3-flash-preview (180K free/month)\n 2. if/kimi-k2-thinking (unlimited)\n 3. qw/qwen3-coder-plus (unlimited)\n\nCost: $0 forever!\n```\n\n
\n\n
\nšŸ”§ CLI Integration\n\n### Cursor IDE\n\n```\nSettings ā†’ Models ā†’ Advanced:\n OpenAI API Base URL: http://localhost:20128/v1\n OpenAI API Key: [from 9router dashboard]\n Model: cc/claude-opus-4-6\n```\n\nOr use combo: `premium-coding`\n\n### Claude Code\n\nEdit `~/.claude/config.json`:\n\n```json\n{\n \"anthropic_api_base\": \"http://localhost:20128/v1\",\n \"anthropic_api_key\": \"your-9router-api-key\"\n}\n```\n\n### Codex CLI\n\n```bash\nexport OPENAI_BASE_URL=\"http://localhost:20128\"\nexport OPENAI_API_KEY=\"your-9router-api-key\"\n\ncodex \"your prompt\"\n```\n\n### OpenClaw\n\n**Option 1 ā€” Dashboard (recommended):**\n\n```\nDashboard ā†’ CLI Tools ā†’ OpenClaw ā†’ Select Model ā†’ Apply\n```\n\n**Option 2 ā€” Manual:** Edit `~/.openclaw/openclaw.json`:\n\n```json\n{\n \"agents\": {\n \"defaults\": {\n \"model\": {\n \"primary\": \"9router/if/glm-4.7\"\n }\n }\n },\n \"models\": {\n \"providers\": {\n \"9router\": {\n \"baseUrl\": \"http://127.0.0.1:20128/v1\",\n \"apiKey\": \"sk_9router\",\n \"api\": \"openai-completions\",\n \"models\": [\n {\n \"id\": \"if/glm-4.7\",\n \"name\": \"glm-4.7\"\n }\n ]\n }\n }\n }\n}\n```\n\n> **Note:** OpenClaw only works with local 9Router. Use `127.0.0.1` instead of `localhost` to avoid IPv6 resolution issues.\n\n### Cline / Continue / RooCode\n\n```\nProvider: OpenAI Compatible\nBase URL: http://localhost:20128/v1\nAPI Key: [from dashboard]\nModel: cc/claude-opus-4-6\n```\n\n
\n\n
\nšŸš€ Deployment\n\n### VPS Deployment\n\n```bash\n# Clone and install\ngit clone https://github.com/decolua/9router.git\ncd 9router\nnpm install\nnpm run build\n\n# Configure\nexport JWT_SECRET=\"your-secure-secret-change-this\"\nexport INITIAL_PASSWORD=\"your-password\"\nexport DATA_DIR=\"/var/lib/9router\"\nexport PORT=\"20128\"\nexport HOSTNAME=\"0.0.0.0\"\nexport NODE_ENV=\"production\"\nexport NEXT_PUBLIC_BASE_URL=\"http://localhost:20128\"\nexport NEXT_PUBLIC_CLOUD_URL=\"https://9router.com\"\nexport API_KEY_SECRET=\"endpoint-proxy-api-key-secret\"\nexport MACHINE_ID_SALT=\"endpoint-proxy-salt\"\n\n# Start\nnpm run start\n\n# Or use PM2\nnpm install -g pm2\npm2 start npm --name 9router -- start\npm2 save\npm2 startup\n```\n\n### Docker\n\n```bash\n# Build image (from repository root)\ndocker build -t 9router .\n\n# Run container (command used in current setup)\ndocker run -d \\\n --name 9router \\\n -p 20128:20128 \\\n --env-file /root/dev/9router/.env \\\n -v 9router-data:/app/data \\\n -v 9router-usage:/root/.9router \\\n 9router\n```\n\nPortable command (if you are already at repository root):\n\n```bash\ndocker run -d \\\n --name 9router \\\n -p 20128:20128 \\\n --env-file ./.env \\\n -v 9router-data:/app/data \\\n -v 9router-usage:/root/.9router \\\n 9router\n```\n\nContainer defaults:\n- `PORT=20128`\n- `HOSTNAME=0.0.0.0`\n\nUseful commands:\n\n```bash\ndocker logs -f 9router\ndocker restart 9router\ndocker stop 9router && docker rm 9router\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `JWT_SECRET` | Auto-generated per process when unset | JWT signing secret for dashboard auth cookie (set a stable random value in production so sessions survive restarts) |\n| `INITIAL_PASSWORD` | `12345677` | First login password when no saved hash exists |\n| `DATA_DIR` | `~/.9router` | Main app database location (`db.json`) |\n| `PORT` | framework default | Service port (`20128` in examples) |\n| `HOSTNAME` | framework default | Bind host (Docker defaults to `0.0.0.0`) |\n| `NODE_ENV` | runtime default | Set `production` for deploy |\n| `BASE_URL` | `http://localhost:20128` | Server-side internal base URL used by cloud sync jobs |\n| `CLOUD_URL` | `https://9router.com` | Server-side cloud sync endpoint base URL |\n| `NEXT_PUBLIC_BASE_URL` | `http://localhost:3000` | Backward-compatible/public base URL (prefer `BASE_URL` for server runtime) |\n| `NEXT_PUBLIC_CLOUD_URL` | `https://9router.com` | Backward-compatible/public cloud URL (prefer `CLOUD_URL` for server runtime) |\n| `API_KEY_SECRET` | `endpoint-proxy-api-key-secret` | HMAC secret for generated API keys |\n| `MACHINE_ID_SALT` | `endpoint-proxy-salt` | Salt for stable machine ID hashing |\n| `ENABLE_REQUEST_LOGS` | `false` | Enables request/response logs under `logs/` |\n| `AUTH_COOKIE_SECURE` | `false` | Force `Secure` auth cookie (set `true` behind HTTPS reverse proxy) |\n| `REQUIRE_API_KEY` | `false` | Enforce Bearer API key on `/v1/*` routes (recommended for internet-exposed deploys) |\n| `HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`, `NO_PROXY` | empty | Optional outbound proxy for upstream provider calls |\n| `REDIS_URL`, `REDIS_HOST`, `REDIS_PORT`, `REDIS_DB`, `REDIS_USERNAME`, `REDIS_PASSWORD`, `REDIS_TLS`, `REDIS_CLIENT_NAME`, `REDIS_CONNECT_TIMEOUT_MS` | empty | Optional Redis backend for hot quota/account state; if unset, local fallback is used |\n\nNotes:\n- Lowercase proxy variables are also supported: `http_proxy`, `https_proxy`, `all_proxy`, `no_proxy`.\n- `.env` is not baked into Docker image (`.dockerignore`); inject runtime config with `--env-file` or `-e`.\n- On Windows, `APPDATA` can be used for local storage path resolution.\n- `INSTANCE_NAME` appears in older docs/env templates, but is currently not used at runtime.\n\n## šŸ”’ Security Configuration\n\n### IP Whitelist\n\nBy default, dashboard access from localhost and Docker networks is allowed. Configure custom IPs in Settings or `data/db.json`:\n\n```json\n{\n \"ipWhitelist\": [\"127.0.0.1\", \"::1\", \"172.17.0.0/16\", \"10.0.0.0/8\"]\n}\n```\n\nSupports:\n- Exact IPs: `127.0.0.1`, `::1`\n- CIDR ranges: `172.17.0.0/16`, `10.0.0.0/8`\n\n### Trusted Proxy Mode\n\nIf behind nginx/Cloudflare, enable trusted proxy to read `X-Forwarded-For`:\n\n```json\n{\n \"trustedProxyEnabled\": true\n}\n```\n\nāš ļø Only enable if you trust the proxy. Malicious proxies can spoof IPs.\n\n### Audit Logging\n\nSecurity events are logged to `data/audit.log` (default: enabled, 10MB max):\n\n```json\n{\n \"auditLogEnabled\": true,\n \"auditLogMaxSize\": 10485760\n}\n```\n\nEvents logged:\n- Login attempts (success/failure)\n- Auth bypass attempts\n- Rate limit exceeded\n- Tunnel access attempts\n\n### Rate Limiting\n\nLogin endpoint: 5 attempts per IP per 15 minutes. Automatic cleanup every 5 minutes.\n\nSee `docs/security/DASHBOARD_AUTH.md` for complete security documentation.\n\n### Runtime Files and Storage\n\n- Main app state: `${DATA_DIR}/db.json` (providers, combos, aliases, keys, settings), managed by `src/lib/localDb.js`.\n- Usage history and logs: `~/.9router/usage.json` and `~/.9router/log.txt`, managed by `src/lib/usageDb.js`.\n- Optional request/translator logs: `/logs/...` when `ENABLE_REQUEST_LOGS=true`.\n- Usage storage currently follows `~/.9router` path logic and is independent from `DATA_DIR`.\n- Hot quota/account state can optionally use Redis when `REDIS_URL` or `REDIS_HOST` is configured; otherwise the app keeps the current local fallback path.\n\n
\n\n---\n\n## šŸ“Š Available Models\n\n
\nView all available models\n\n**Claude Code (`cc/`)** - Pro/Max:\n- `cc/claude-opus-4-6`\n- `cc/claude-sonnet-4-5-20250929`\n- `cc/claude-haiku-4-5-20251001`\n\n**Codex (`cx/`)** - Plus/Pro:\n- `cx/gpt-5.2-codex`\n- `cx/gpt-5.1-codex-max`\n\n**Gemini CLI (`gc/`)** - FREE:\n- `gc/gemini-3-flash-preview`\n- `gc/gemini-2.5-pro`\n\n**GitHub Copilot (`gh/`)**:\n- `gh/gpt-5`\n- `gh/claude-4.5-sonnet`\n\n**GLM (`glm/`)** - $0.6/1M:\n- `glm/glm-4.7`\n\n**MiniMax (`minimax/`)** - $0.2/1M:\n- `minimax/MiniMax-M2.1`\n\n**iFlow (`if/`)** - FREE:\n- `if/kimi-k2-thinking`\n- `if/qwen3-coder-plus`\n- `if/deepseek-r1`\n\n**Qwen (`qw/`)** - FREE:\n- `qw/qwen3-coder-plus`\n- `qw/qwen3-coder-flash`\n\n**Kiro (`kr/`)** - FREE:\n- `kr/claude-sonnet-4.5`\n- `kr/claude-haiku-4.5`\n\n
\n\n---\n\n## šŸ› Troubleshooting\n\n**\"Language model did not provide messages\"**\n- Provider quota exhausted ā†’ Check dashboard quota tracker\n- Solution: Use combo fallback or switch to cheaper tier\n\n**Rate limiting**\n- Subscription quota out ā†’ Fallback to GLM/MiniMax\n- Add combo: `cc/claude-opus-4-6 ā†’ glm/glm-4.7 ā†’ if/kimi-k2-thinking`\n\n**OAuth token expired**\n- Auto-refreshed by 9Router\n- If issues persist: Dashboard ā†’ Provider ā†’ Reconnect\n\n**High costs**\n- Check usage stats in Dashboard\n- Switch primary model to GLM/MiniMax\n- Use free tier (Gemini CLI, iFlow) for non-critical tasks\n\n**Dashboard opens on wrong port**\n- Set `PORT=20128` and `NEXT_PUBLIC_BASE_URL=http://localhost:20128`\n\n**First login not working**\n- Check `INITIAL_PASSWORD` in `.env`\n- If unset, fallback password is `12345677`\n\n**No request logs under `logs/`**\n- Set `ENABLE_REQUEST_LOGS=true`\n\n---\n\n## šŸ› ļø Tech Stack\n\n- **Runtime**: Node.js 20+\n- **Framework**: Next.js 16\n- **UI**: React 19 + Tailwind CSS 4\n- **Database**: LowDB (JSON file-based)\n- **Streaming**: Server-Sent Events (SSE)\n- **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys\n\n---\n\n## šŸ“ API Reference\n\n### Chat Completions\n\n```bash\nPOST http://localhost:20128/v1/chat/completions\nAuthorization: Bearer your-api-key\nContent-Type: application/json\n\n{\n \"model\": \"cc/claude-opus-4-6\",\n \"messages\": [\n {\"role\": \"user\", \"content\": \"Write a function to...\"}\n ],\n \"stream\": true\n}\n```\n\n### List Models\n\n```bash\nGET http://localhost:20128/v1/models\nAuthorization: Bearer your-api-key\n\nā†’ Returns all models + combos in OpenAI format\n```\n\n## šŸ“§ Support\n\n- **Website**: [9router.com](https://9router.com)\n- **GitHub**: [github.com/decolua/9router](https://github.com/decolua/9router)\n- **Issues**: [github.com/decolua/9router/issues](https://github.com/decolua/9router/issues)\n\n---\n\n## šŸ‘„ Contributors\n\nThanks to all contributors who helped make 9Router better!\n\n[![Contributors](https://contrib.rocks/image?repo=decolua/9router&max=150&columns=15&anon=1&v=20260309)](https://github.com/decolua/9router/graphs/contributors)\n\n---\n\n## šŸ“Š Star Chart\n\n[![Star Chart](https://starchart.cc/decolua/9router.svg?variant=adaptive)](https://starchart.cc/decolua/9router)\n\n\n\n## šŸ”€ Forks\n\n**[OmniRoute](https://github.com/diegosouzapw/OmniRoute)** ā€” A full-featured TypeScript fork of 9Router. Adds 36+ providers, 4-tier auto-fallback, multi-modal APIs (images, embeddings, audio, TTS), circuit breaker, semantic cache, LLM evaluations, and a polished dashboard. 368+ unit tests. Available via npm and Docker.\n\n---\n\n## šŸ™ Acknowledgments\n\nSpecial thanks to **CLIProxyAPI** - the original Go implementation that inspired this JavaScript port.\n\n---\n\n## šŸ“„ License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n
\n Built with ā¤ļø for developers who code 24/7\n
\n","readmeFilename":"README.md"}