\n\nAutomated intelligent system that aggregates **100+ free AI coding models** from top providers, validates them via **live pre-tests** directly through 9router, ranks them by empirical coding benchmarks & latency, and injects them into ready-to-use 9router combos (`my9model-free`, `my9model-smart`, `my9model-fast`, `openagentic-free`, `kilo-free`, etc.) — allowing Cursor, Claude Code, Cline, and your IDEs to always use active, high-quality, and lowest-latency free AI models without key management headaches.\n\n> **Security Note**: This script reads provider credentials from **connections already configured in your 9router SQLite database**. No API keys are stored in or transmitted by this repository.\n\n
\n \n
\n\n---\n\n## 🌐 Modern Interactive Web Management Console\n\n9router-auto-free includes a built-in dark-themed **Web Management Console** on port `20129`:\n\n- **Unified Authentication**: Login using the same password as your 9router dashboard.\n- **Top 5 Leaderboard**: Real-time ranking of top free coding models with benchmark scores & latencies.\n- **Provider Monitoring & Auto-Sync Switch**: Monitor active provider connections from 9router (OAuth & API Key) and toggle Auto-Sync per provider. All credentials remain securely managed inside 9router.\n- **Visual Exclusions & Priorities**: Manage `exclusions.json` and `priorities.json` with tag-based UI or raw JSON editor.\n- **Real-Time Streaming CLI Console**: Execute *Sync*, *Dry Run*, *Watchdog Refresh*, and *Scheduler Setup* with live SSE log streaming.\n- **Full Bilingual Support & In-App User Guide**: Instant toggle between **English 🇬🇧** and **Bahasa Indonesia 🇮🇩** with complete 1:1 documentation, IDE tutorials, and FAQ built directly into the console.\n\n```bash\n# Start the Web Console\nnpx 9router-auto-free --web\n# Or with verbose logging for terminal debugging\nnpx 9router-auto-free --web --verbose\n# Or locally:\nnpm run web\n# node web.js --verbose\n```\nAccess in your browser: `http://localhost:20129`\n\n---\n\n## 🚀 Installation & Usage via NPM / NPX\n\n### 1. Zero-Install (via NPX)\n\n```bash\n# Run Full Daily Sync immediately\nnpx 9router-auto-free\n\n# Launch Web Console Dashboard\nnpx 9router-auto-free --web\n\n# Simulate sync without modifying SQLite database (Dry Run)\nnpx 9router-auto-free --dry-run\n\n# Intra-day watchdog refresh (check quota & HTTP 429 status)\nnpx 9router-auto-free --refresh\n\n# Setup automated daily & hourly scheduling\nnpx 9router-auto-free --setup-cron\n```\n\n### 2. Global Installation\n\n```bash\nnpm install -g 9router-auto-free\n\n# Run commands directly from terminal\n9router-auto-free\n9router-auto-free --web\n9router-auto-free --dry-run\n```\n\n---\n\n## ⚙️ How It Works (6-Stage Automated Pipeline)\n\n1. **Scrape & Discover**: Fetches candidate free model lists across 15+ built-in providers and active dynamic SQLite connections.\n2. **Exclusions Filter**: Discards non-coding models (TTS, embeddings, vision-only, nano models) and blacklisted providers.\n3. **Parallel Live Pre-Test**: Tests each model candidate through 9router's internal endpoints (`POST /api/models/test`) to measure real HTTP status and latency.\n4. **Verdict & Auto-Cooldown**: HTTP 200 models pass; rate-limited (429) models are parked in `my9model-cooldown`; dead models are pruned.\n5. **Coding Quality Ranking**: Ranks models by empirical benchmarks (EvalPlus, SWE-bench), adjusted by usage reliability penalties and latency.\n6. **SQLite Injection**: Writes the ranked model lists directly to 9router SQLite database. Your IDE immediately benefits from fresh models.\n\n---\n\n## 📦 Managed Combos\n\n### 🌟 Unified Super Combos (Cross-Provider)\n\n| Combo | Description & Recommendation |\n|---|---|\n| `my9model-free` | **Main super combo**: Comprehensive pool of all active free models across all providers, ranked with top coding capability and lowest latency first. Best for daily programming. |\n| `my9model-smart` | **High reasoning & thinking tier**: Dedicated to thinking models (Claude 3.7 Sonnet Thinking, Qwen Coder, DeepSeek R1) or highest coding benchmarks. Best for complex architectures & tough debugging. |\n| `my9model-fast` | **Ultra-low latency tier**: Lightning-fast models (Groq, Cerebras, Kilo, etc.) with sub-second response times. Perfect for autocomplete and inline code completions. |\n| `my9model-cooldown` | **Rate-limit quarantine (429)**: Holding area for models whose daily quota is exhausted. The hourly watchdog automatically restores them once quotas reset. |\n\n### 🔌 Provider-Specific Combos\n\n| Provider | Prefix | Output Combo |\n|---|---|---|\n| **OpenAgentic.id** | `openagentic` | `openagentic-free` |\n| **Kilo.ai (KiloCode)** | `kc` | `kilo-free` |\n| **OpenRouter** | `openrouter` | `openrouter-free` |\n| **Google Gemini** | `gemini` | `gemini-free` |\n| **Groq** | `groq` | `groq-free` |\n| **Cerebras** | `cerebras` | `cerebras-free` |\n| **Mistral AI** | `mistral` | `mistral-free` |\n| **Cloudflare Workers AI** | `cloudflare-ai` | `cloudflare-free` |\n| **Poolside** | `poolside` | `poolside-free` |\n| **Ollama Cloud** | `ollama` | `ollama-free` |\n| **API.airforce** | `api-airforce` | `airforce-free` |\n| **Bazaarlink** | `bazaarlink` | `bazaarlink-free` |\n| **B.ai** | `b-ai` | `b.ai-free` |\n| **NVIDIA NIM** | `nvidia` | `nvidia-free` |\n| **9router OpenCode** | `oc` | `opencode-free` |\n| **Dynamic OpenAI Nodes** | `` | `-free` |\n\n---\n\n## 💻 Connecting to IDEs & AI Coding Tools\n\nPoint your OpenAI-Compatible client to 9router:\n\n- **OpenAI Base URL**: `http://localhost:20128/v1`\n- **API Key**: API Key from your 9router Dashboard\n- **Model Name**: `my9model-free` (or `my9model-smart`, `my9model-fast`)\n\n### Quick Setup Examples:\n- **Claude Code**:\n ```bash\n claude --model openai/my9model-free\n ```\n- **Cursor**:\n - Open *Settings* → *Models* → *OpenAI API*.\n - Set Base URL to `http://localhost:20128/v1` and Model to `my9model-free`.\n- **Aider**:\n ```bash\n export OPENAI_API_BASE=http://localhost:20128/v1\n aider --model openai/my9model-free\n ```\n\n---\n\n## ⏰ Automated Scheduling\n\nEnable the automated daily sync (00:05) and hourly quota watchdog (:35) with:\n\n```bash\nnpx 9router-auto-free --setup-cron\n```\n*(On Linux it automatically installs Systemd User Timers; on macOS/Windows/WSL it installs crontab).*\n\n---\n\n## 📄 License & Author\n\nCreated by **[Herliansyah](https://github.com/herliansyah)**.\n\nLicensed under the [MIT License](LICENSE).\n","readmeFilename":"README.md"}
![\"npm](\"https://img.shields.io/npm/v/9router-auto-free.svg?style=flat-square&color=cb3837&logo=npm\")
\n ![\"npm](\"https://img.shields.io/npm/dt/9router-auto-free.svg?style=flat-square&color=blue\")
\n ![\"npm](\"https://img.shields.io/npm/dm/9router-auto-free.svg?style=flat-square&color=brightgreen\")
\n ![\"license\"](\"https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square\"){kind=icon}
\n![\"9router](\"https://raw.githubusercontent.com/herliansyah/9router-auto-free/master/assets/dashboard.png\")
\n