decolua / 9router

# 9Router - Free AI Router **Never stop coding. Auto-route to FREE & cheap AI models with smart fallback.** **Connect All AI Code Tools (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) to 40+ AI Providers & 100+ Models.** 🚀 Quick Start • 💡 Features • 📖 Setup • 🌐 Website 🇻🇳 Tiếng Việt • 🇨🇳 中文 • 🇯🇵 日本語 --- 🤔 Why 9Router? **Stop wasting money and hitting limits:** • ❌ Subscription quota expires unused every month • ❌ Rate limits stop you mid-coding • ❌ Expensive APIs ($20-50/month per provider) • ❌ Manual switching between providers **9Router solves this:** • ✅ **Maximize subscriptions** - Track quota, use every bit before reset • ✅ **Auto fallback** - Subscription → Cheap → Free, zero downtime • ✅ **Multi-account** - Round-robin between accounts per provider • ✅ **Universal** - Works with Claude Code, Codex, Gemini CLI, Cursor, Cline, any CLI tool --- 🔄 How It Works --- ⚡ Quick Start **1. Install globally:** 🎉 Dashboard opens at **2. Connect a FREE provider (no signup needed):** Dashboard → Providers → Connect **Claude Code** or **Antigravity** → OAuth login → Done! **3. Use in your CLI tool:** **That's it!** Start coding with FREE AI models. **Alternative: run from source (this repository):** This repository package is private ( ), so source/Docker execution is the expected local development path. Production mode: Default URLs: • Dashboard: • OpenAI-compatible API: --- 🎥 Video Tutorial 📺 Complete Setup Guide - 9Router + Claude Code FREE **🎬 Watch the complete step-by-step tutorial:** • ✅ 9Router installation & setup • ✅ FREE Claude Sonnet 4.5 configuration • ✅ Claude Code integration • ✅ Live coding demonstration **⏱️ Duration:** 20 minutes | **👥 By:** Developer Community ▶️ Watch on YouTube --- 🛠️ Supported CLI Tools 9Router works seamlessly with all major AI coding tools: Claude-Code OpenClaw Codex OpenCode Cursor Antigravity Cline Continue Droid Roo Copilot Kilo Code --- 🌐 Supported Providers 🔐 OAuth Providers Claude-Code Antigravity Codex GitHub Cursor 🆓 Free Providers iFlow AI 8+ models • Unlimited Qwen Code 3+ models • Unlimited Gemini CLI 180K/month FREE Kiro AI Claude • Unlimited 🔑 API Key Providers (40+) OpenRouter GLM Kimi MiniMax OpenAI Anthropic Gemini DeepSeek Groq xAI Mistral Perplexity Together AI Fireworks Cerebras Cohere NVIDIA SiliconFlow ...and 20+ more providers including Nebius, Chutes, Hyperbolic, and custom OpenAI/Anthropic compatible endpoints --- 💡 Key Features | Feature | What It Does | Why It Matters | |---------|--------------|----------------| | 🎯 **Smart 3-Tier Fallback** | Auto-route: Subscription → Cheap → Free | Never stop coding, zero downtime | | 📊 **Real-Time Quota Tracking** | Live token count + reset countdown | Maximize subscription value | | 🔄 **Format Translation** | OpenAI ↔ Claude ↔ Gemini seamless | Works with any CLI tool | | 👥 **Multi-Account Support** | Multiple accounts per provider | Load balancing + redundancy | | 🔄 **Auto Token Refresh** | OAuth tokens refresh automatically | No manual re-login needed | | 🎨 **Custom Combos** | Create unlimited model combinations | Tailor fallback to your needs | | 📝 **Request Logging** | Debug mode with full request/response logs | Troubleshoot issues easily | | 💾 **Cloud Sync** | Sync config across devices | Same setup everywhere | | 📊 **Usage Analytics** | Track tokens, cost, trends over time | Optimize spending | | 🌐 **Deploy Anywhere** | Localhost, VPS, Docker, Cloudflare Workers | Flexible deployment options | 📖 Feature Details 🎯 Smart 3-Tier Fallback Create combos with automatic fallback: 📊 Real-Time Quota Tracking • Token consumption per provider • Reset countdown (5-hour, daily, weekly) • Cost estimation for paid tiers • Monthly spending reports 🔄 Format Translation Seamless translation between formats: • **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses** • Your CLI tool sends OpenAI format → 9Router translates → Provider receives native format • Works with any tool that supports custom OpenAI endpoints 👥 Multi-Account Support • Add multiple accounts per provider • Auto round-robin or priority-based routing • Fallback to next account when one hits quota 🔄 Auto Token Refresh • OAuth tokens automatically refresh before expiration • No manual re-authentication needed • Seamless experience across all providers 🎨 Custom Combos • Create unlimited model combinations • Mix subscription, cheap, and free tiers • Name your combos for easy access • Share combos across devices with Cloud Sync 📝 Request Logging • Enable debug mode for full request/response logs • Track API calls, headers, and payloads • Troubleshoot integration issues • Export logs for analysis 💾 Cloud Sync • Sync providers, combos, and settings across devices • Automatic background sync • Secure encrypted storage • Access your setup from anywhere Cloud Runtime Notes • Prefer server-side cloud variables in production: • (internal callback URL used by sync scheduler) • (cloud sync endpoint base) • and are still supported for compatibility/UI, but server runtime now prioritizes / . • Cloud sync requests now use timeout + fail-fast behavior to avoid UI hanging when cloud DNS/network is unavailable. 📊 Usage Analytics • Track token usage per provider and model • Cost estimation and spending trends • Monthly reports and insights • Optimize your AI spending > **💡 IMPORTANT - Understanding Dashboard Costs:** > > The "cost" displayed in Usage Analytics is **for tracking and comparison purposes only**. > 9Router itself **never charges** you anything. You only pay providers directly (if using paid services). > > **Example:** If your dashboard shows "$290 total cost" while using iFlow models, this represents > what you would have paid using paid APIs directly. Your actual cost = **$0** (iFlow is free unlimited). > > Think of…