free-coding-models 0.5.92 → 0.5.93

package/README.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   <strong>Find the fastest free coding model in seconds.</strong><br>
-  Live latency, stability and verdicts for 228 models from 24 free AI providers, then install the one you pick straight into your favorite coding tool.<br><br>
+  Live latency, stability and verdicts for 251 models from 24 free AI providers, then install the one you pick straight into your favorite coding tool.<br><br>
   <strong>Works with:</strong> OpenCode CLI / Desktop / WebUI, OpenClaw, Crush, Goose, Aider, Kilo CLI, Qwen Code, OpenHands, Amp, Hermes, Continue, Cline, Xcode, Pi, ZCode, ForgeCode, Copilot, jcode, Caveman Code and more.
 </p>
 
@@ -35,7 +35,7 @@ free-coding-models
 
 ## 💡 Why this tool?
 
-There is a large catalog of free and free-limited coding models (**24 providers / 228 live models**, generated from [`sources.js`](./sources.js)). Which one is fastest *right now*? Which one is actually stable, versus just lucky on the last ping?
+There is a large catalog of free and free-limited coding models (**24 providers / 251 live models**, generated from [`sources.js`](./sources.js)). Which one is fastest *right now*? Which one is actually stable, versus just lucky on the last ping?
 
 `free-coding-models` (FCM) answers that by pinging every model in parallel, showing live latency, and computing a **live Stability Score (0-100)** combining p95 latency, jitter, spike rate and uptime. Average latency alone is misleading: a model that randomly spikes to 6 seconds is not reliable.
 
@@ -87,18 +87,20 @@ free-coding-models --fiable              # print the single most reliable model
 
 ## 🟢 Providers
 
-**24 active providers / 228 live models**, sorted by live model count. Top 8:
+**24 active providers / 251 live models**, sorted by live model count. Top 8:
 
 | Provider | Models | Best tier | Env var |
 |----------|--------|-----------|---------|
-| [Alibaba DashScope](https://modelstudio.console.alibabacloud.com) | 27 | S+ | `DASHSCOPE_API_KEY` |
-| [Ollama Cloud](https://ollama.com/settings/keys) | 19 | S+ | `OLLAMA_API_KEY` |
-| [OpenRouter](https://openrouter.ai/keys) | 19 | S+ | `OPENROUTER_API_KEY` |
-| [Cloudflare AI](https://dash.cloudflare.com) | 15 | S | `CLOUDFLARE_API_TOKEN` |
-| [Kilo](https://kilo.ai) | 14 | S+ | `KILO_API_KEY` |
-| [NVIDIA NIM](https://build.nvidia.com) | 13 | S+ | `NVIDIA_API_KEY` |
+| [Alibaba DashScope](https://modelstudio.console.alibabacloud.com) | 25 | S+ | `DASHSCOPE_API_KEY` |
+| [Cloudflare AI](https://dash.cloudflare.com) | 21 | S+ | `CLOUDFLARE_API_TOKEN` |
+| [Ollama Cloud](https://ollama.com/settings/keys) | 20 | S+ | `OLLAMA_API_KEY` |
+| [OpenRouter](https://openrouter.ai/keys) | 20 | S+ | `OPENROUTER_API_KEY` |
+| [Kilo](https://kilo.ai) | 18 | S+ | `KILO_API_KEY` |
+| [NVIDIA NIM](https://build.nvidia.com) | 16 | S+ | `NVIDIA_API_KEY` |
+| [OVHcloud AI](https://endpoints.ai.cloud.ovh.net) | 13 | S+ | `OVH_AI_ENDPOINTS_ACCESS_TOKEN` |
 | [Pollinations AI](https://enter.pollinations.ai) | 13 | S+ | `POLLINATIONS_API_KEY` |
-| [OVHcloud AI](https://endpoints.ai.cloud.ovh.net) | 12 | S+ | `OVH_AI_ENDPOINTS_ACCESS_TOKEN` |
+
+> 🧾 **What "free" means here:** free is a property of the *(provider, model)* pair, never of the provider as a whole. A row is listed only when that exact model id costs $0 to call through that provider (permanent free tier, `:free` variant, or free plan), verified live at audit time. The same open-weights model can be free on one host and paid on another - paid siblings are deliberately excluded. Full breakdown and badge legend: [`docs/providers.md`](./docs/providers.md).
 
 > 📖 **Full table, free-tier limits, env vars, tier scale and provider notes:** [`docs/providers.md`](./docs/providers.md) (generated from `sources.js` by `node scripts/generate-provider-table.mjs`, so counts cannot drift). OpenCode Zen's free models are listed there too.
 
@@ -247,7 +249,7 @@ Keys live locally in `~/.free-coding-models.json` (`0600`) and are only ever sen
 
 ## Contributors
 
-Created and maintained by [Vanessa Depraute](https://vanessadepraute.dev) ([@vava-nessa](https://github.com/vava-nessa)), with contributions from [@erwinh22](https://github.com/erwinh22), [@whit3rabbit](https://github.com/whit3rabbit), [@skylaweber](https://github.com/skylaweber), [@PhucTruong-ctrl](https://github.com/PhucTruong-ctrl), [@chindris-mihai-alexandru](https://github.com/chindris-mihai-alexandru), [@serajbaltu](https://github.com/serajbaltu), [@stgreenb](https://github.com/stgreenb), [@MoriDanWork](https://github.com/MoriDanWork), [@fan92rus](https://github.com/fan92rus), [@Muhammad95959](https://github.com/Muhammad95959), [@FaintFlower](https://github.com/FaintFlower), [@lehneres](https://github.com/lehneres), [@ia-S-on](https://github.com/ia-S-on) and [@bangla24bdrang-lab](https://github.com/bangla24bdrang-lab).
+Created and maintained by [Vanessa Depraute](https://vanessadepraute.dev) ([@vava-nessa](https://github.com/vava-nessa)), with contributions from [@erwinh22](https://github.com/erwinh22), [@whit3rabbit](https://github.com/whit3rabbit), [@skylaweber](https://github.com/skylaweber), [@PhucTruong-ctrl](https://github.com/PhucTruong-ctrl), [@chindris-mihai-alexandru](https://github.com/chindris-mihai-alexandru), [@serajbaltu](https://github.com/serajbaltu), [@stgreenb](https://github.com/stgreenb), [@MoriDanWork](https://github.com/MoriDanWork), [@fan92rus](https://github.com/fan92rus), [@Muhammad95959](https://github.com/Muhammad95959), [@FaintFlower](https://github.com/FaintFlower), [@lehneres](https://github.com/lehneres), [@ia-S-on](https://github.com/ia-S-on), [@bangla24bdrang-lab](https://github.com/bangla24bdrang-lab) and [@Sy57em1](https://github.com/Sy57em1).
 
 → Full credits and highlighted contributions: [`CONTRIBUTORS.md`](./CONTRIBUTORS.md)
 

package/changelog/v0.5.93.md

@@ -0,0 +1,21 @@
+# Changelog v0.5.93 - 2026-09-21
+
+### Fixed
+
+- **Mistral provider fully revived** (PR #185 by [@Sy57em1](https://github.com/Sy57em1)). The 2026-09-15 audit had rewritten every Mistral model id into a date-stamped form the API does not accept, so since v0.5.92 all 9 Mistral models returned `400 invalid_model` and the whole provider was dead. Every id was re-verified against the live `GET https://api.mistral.ai/v1/models` on a real Experiment-plan key:
+  - Restored: `mistral-medium-3-5`, `magistral-medium-latest` (moved to A+), `mistral-small-2603`, `ministral-14b-2512`, `ministral-8b-2512`, `ministral-3b-2512`
+  - Removed: Mistral Large 3 (no `large` model exists upstream at all), Z.ai GLM 5.2 (403 `tier_not_allowed`, paid tier only, never belonged in a free catalog), Mistral Small Creative (absent from the live catalog)
+  - `ministral-3b-2512` context window corrected 256k to 128k, taken from the model's real `max_context_length`
+  - Router daemon test updated to route through a model that exists
+
+### Added
+
+- **"What does free mean here?" is now documented everywhere** (issue #186). Free is a property of the *(provider, model)* pair, never of the provider: a row is listed only when that exact model id costs $0 through that specific provider, verified live. The same open-weights model can be free on one host and paid on another. New content:
+  - `docs/providers.md`: full explainer section with the three-badge legend, generated by `scripts/generate-provider-table.mjs` so it cannot drift
+  - README: summary paragraph in the Providers section
+  - Web Dashboard models page: quota badge tooltips plus a legend line under the table, matching the badge colors (Free = recurring $0 tier, Limited = depleting allowance, Metered = $0-priced passthrough)
+- [@Sy57em1](https://github.com/Sy57em1) added to the contributors lists.
+
+### Changed
+
+- Docs counts refreshed after the audit and the Mistral fix: **24 providers / 251 live models** (was displaying a stale 228), README top-8 provider table regenerated from `sources.js`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.5.92",
+  "version": "0.5.93",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/sources.js

@@ -203,21 +203,28 @@ export const githubModels = [
 // 📖 Mistral La Plateforme source - https://console.mistral.ai
 // 📖 Experiment plan is free for evaluation/prototyping and exposes general + coding models.
 // 📖 Keep Codestral as a separate provider key for backward compatibility with existing configs.
+// 📖 Fixed (2026-09-16): every id below re-verified against the live
+// 📖 GET https://api.mistral.ai/v1/models on a real Experiment-plan key.
+// 📖 The 2026-09-15 audit had rewritten the working ids into a date-stamped
+// 📖 form that Mistral does not accept, so ALL nine entries returned
+// 📖 400 invalid_model and the whole provider was dead. Context windows now
+// 📖 come from each model's `max_context_length` instead of a blanket 256k.
 export const mistral = [
   // ── S+ tier — SWE-bench Verified ≥70% ──
-  ['mistral-large-3-25-12', 'Mistral Large 3', 'S+', '70.0%', '256k'], // Fixed ID (2026-09-15): mistral-large-2512 → mistral-large-3-25-12 (docs.mistral.ai/models)
-  ['mistral-medium-3-5-26-04', 'Mistral Medium 3.5', 'S+', '77.6%', '256k'], // Fixed ID (2026-09-15): mistral-medium-3-5 → mistral-medium-3-5-26-04 (docs.mistral.ai/models)
+  ['mistral-medium-3-5', 'Mistral Medium 3.5', 'S+', '77.6%', '256k'], // Fixed (2026-09-16): mistral-medium-3-5-26-04 → mistral-medium-3-5 (live /v1/models, ctx 262144)
   // Removed (2026-08-13): devstral-2512 (Devstral 2) — Mistral deprecation, full retirement 2026-07-31
-  ['zai-glm-5-2', 'Z.ai GLM 5.2', 'S+', '82.8%', '1M'],
+  // Removed (2026-09-16): mistral-large-3-25-12 (Mistral Large 3) — no `large` model exists in the live catalog at all
+  // Removed (2026-09-16): zai-glm-5-2 (Z.ai GLM 5.2) — absent from /v1/models; a direct call returns 403 tier_not_allowed (paid tier only), so it never belonged in a free catalog
+  // ── A+ tier ──
+  ['magistral-medium-latest', 'Magistral Medium', 'A+', '-', '256k'], // Fixed (2026-09-16): magistral-medium-1-2-25-09 → magistral-medium-latest (only the -latest alias exists upstream)
   // ── A tier — SWE-bench Verified 40–50% ──
-  ['mistral-small-4-0-26-03', 'Mistral Small 4', 'A', '48.0%', '256k'], // Fixed ID (2026-09-15): mistral-small-2603 → mistral-small-4-0-26-03 (docs.mistral.ai/models)
+  ['mistral-small-2603', 'Mistral Small 4', 'A', '48.0%', '256k'], // Fixed (2026-09-16): mistral-small-4-0-26-03 → mistral-small-2603 (live /v1/models, ctx 262144)
   // ── B+ tier — SWE-bench Verified 30–35% ──
-  ['ministral-3-14b-25-12', 'Ministral 3 14B', 'B+', '-', '256k'], // Fixed (2026-08-13): id 'ministral-3-14b-25-12' → 'ministral-14b-2512' (API model ID per Mistral docs JSON) // Fixed ID (2026-09-15): ministral-14b-2512 → ministral-3-14b-25-12 (docs.mistral.ai/models)
+  ['ministral-14b-2512', 'Ministral 3 14B', 'B+', '-', '256k'], // Fixed (2026-09-16): ministral-3-14b-25-12 → ministral-14b-2512 (live /v1/models, ctx 262144)
   // ── B tier — SWE-bench Verified 20–30% ──
-  ['ministral-3-8b-25-12', 'Ministral 3 8B', 'B', '-', '256k'], // Fixed (2026-08-13): id 'ministral-3-8b-25-12' → 'ministral-8b-2512' // Fixed ID (2026-09-15): ministral-8b-2512 → ministral-3-8b-25-12 (docs.mistral.ai/models)
-  ['ministral-3-3b-25-12', 'Ministral 3 3B', 'B', '-', '256k'], // Fixed (2026-08-13): id 'ministral-3-3b-25-12' → 'ministral-3b-2512' // Fixed ID (2026-09-15): ministral-3b-2512 → ministral-3-3b-25-12 (docs.mistral.ai/models)
-  ['mistral-small-creative-25-12', 'Mistral Small Creative (Labs)', 'B', '-', '256k'], // Added (2026-09-15) — verified via live audit
-  ['magistral-medium-1-2-25-09', 'Magistral Medium 1.2', 'A+', '-', '256k'], // Added (2026-09-15) — verified via live audit
+  ['ministral-8b-2512', 'Ministral 3 8B', 'B', '-', '256k'], // Fixed (2026-09-16): ministral-3-8b-25-12 → ministral-8b-2512 (live /v1/models, ctx 262144)
+  ['ministral-3b-2512', 'Ministral 3 3B', 'B', '-', '128k'], // Fixed (2026-09-16): ministral-3-3b-25-12 → ministral-3b-2512; ctx 256k → 128k (max_context_length 131072)
+  // Removed (2026-09-16): mistral-small-creative-25-12 (Mistral Small Creative) — absent from the live catalog
 ]
 
 // 📖 Mistral Codestral source - https://codestral.mistral.ai