free-coding-models 0.1.63 → 0.1.65

package/lib/config.js

@@ -17,6 +17,10 @@
  *       "cerebras":   "csk_xxx",
  *       "sambanova":  "sn-xxx",
  *       "openrouter": "sk-or-xxx",
+ *       "huggingface":"hf_xxx",
+ *       "replicate":  "r8_xxx",
+ *       "deepinfra":  "di_xxx",
+ *       "fireworks":  "fw_xxx",
  *       "codestral":  "csk-xxx",
  *       "hyperbolic": "eyJ...",
  *       "scaleway":   "scw-xxx",
@@ -28,11 +32,18 @@
  *       "cerebras":   { "enabled": true },
  *       "sambanova":  { "enabled": true },
  *       "openrouter": { "enabled": true },
+ *       "huggingface":{ "enabled": true },
+ *       "replicate":  { "enabled": true },
+ *       "deepinfra":  { "enabled": true },
+ *       "fireworks":  { "enabled": true },
  *       "codestral":  { "enabled": true },
  *       "hyperbolic": { "enabled": true },
  *       "scaleway":   { "enabled": true },
  *       "googleai":   { "enabled": true }
  *     },
+ *     "favorites": [
+ *       "nvidia/deepseek-ai/deepseek-v3.2"
+ *     },
  *     "telemetry": {
  *       "enabled": true,
  *       "consentVersion": 1,
@@ -48,6 +59,7 @@
  *   → loadConfig() — Read ~/.free-coding-models.json; auto-migrate old plain-text config if needed
  *   → saveConfig(config) — Write config to ~/.free-coding-models.json with 0o600 permissions
  *   → getApiKey(config, providerKey) — Get effective API key (env var override > config > null)
+ *   → isProviderEnabled(config, providerKey) — Check if provider is enabled (defaults true)
  *
  * @exports loadConfig, saveConfig, getApiKey
  * @exports CONFIG_PATH — path to the JSON config file
@@ -74,6 +86,10 @@ const ENV_VARS = {
   cerebras:   'CEREBRAS_API_KEY',
   sambanova:  'SAMBANOVA_API_KEY',
   openrouter: 'OPENROUTER_API_KEY',
+  huggingface:['HUGGINGFACE_API_KEY', 'HF_TOKEN'],
+  replicate:  'REPLICATE_API_TOKEN',
+  deepinfra:  ['DEEPINFRA_API_KEY', 'DEEPINFRA_TOKEN'],
+  fireworks:  'FIREWORKS_API_KEY',
   codestral:  'CODESTRAL_API_KEY',
   hyperbolic: 'HYPERBOLIC_API_KEY',
   scaleway:   'SCALEWAY_API_KEY',
@@ -91,7 +107,7 @@ const ENV_VARS = {
  * 📖 The migration reads the old file as a plain nvidia API key and writes
  *    a proper JSON config. The old file is NOT deleted (safety first).
  *
- * @returns {{ apiKeys: Record<string,string>, providers: Record<string,{enabled:boolean}>, telemetry: { enabled: boolean | null, consentVersion: number, anonymousId: string | null } }}
+ * @returns {{ apiKeys: Record<string,string>, providers: Record<string,{enabled:boolean}>, favorites: string[], telemetry: { enabled: boolean | null, consentVersion: number, anonymousId: string | null } }}
  */
 export function loadConfig() {
   // 📖 Try new JSON config first
@@ -102,6 +118,9 @@ export function loadConfig() {
       // 📖 Ensure the shape is always complete — fill missing sections with defaults
       if (!parsed.apiKeys) parsed.apiKeys = {}
       if (!parsed.providers) parsed.providers = {}
+      // 📖 Favorites: list of "providerKey/modelId" pinned rows.
+      if (!Array.isArray(parsed.favorites)) parsed.favorites = []
+      parsed.favorites = parsed.favorites.filter((fav) => typeof fav === 'string' && fav.trim().length > 0)
       if (!parsed.telemetry || typeof parsed.telemetry !== 'object') parsed.telemetry = { enabled: null, consentVersion: 0, anonymousId: null }
       if (typeof parsed.telemetry.enabled !== 'boolean') parsed.telemetry.enabled = null
       if (typeof parsed.telemetry.consentVersion !== 'number') parsed.telemetry.consentVersion = 0
@@ -138,7 +157,7 @@ export function loadConfig() {
  * 📖 Uses mode 0o600 so the file is only readable by the owning user (API keys!).
  * 📖 Pretty-prints JSON for human readability.
  *
- * @param {{ apiKeys: Record<string,string>, providers: Record<string,{enabled:boolean}>, telemetry?: { enabled?: boolean | null, consentVersion?: number, anonymousId?: string | null } }} config
+ * @param {{ apiKeys: Record<string,string>, providers: Record<string,{enabled:boolean}>, favorites?: string[], telemetry?: { enabled?: boolean | null, consentVersion?: number, anonymousId?: string | null } }} config
  */
 export function saveConfig(config) {
   try {
@@ -163,7 +182,10 @@ export function saveConfig(config) {
 export function getApiKey(config, providerKey) {
   // 📖 Env var override — takes precedence over everything
   const envVar = ENV_VARS[providerKey]
-  if (envVar && process.env[envVar]) return process.env[envVar]
+  const envCandidates = Array.isArray(envVar) ? envVar : [envVar]
+  for (const candidate of envCandidates) {
+    if (candidate && process.env[candidate]) return process.env[candidate]
+  }
 
   // 📖 Config file value
   const key = config?.apiKeys?.[providerKey]
@@ -193,6 +215,8 @@ function _emptyConfig() {
   return {
     apiKeys: {},
     providers: {},
+    // 📖 Pinned favorites rendered at top of the table ("providerKey/modelId").
+    favorites: [],
     // 📖 Telemetry consent is explicit. null = not decided yet.
     telemetry: {
       enabled: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "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

@@ -27,8 +27,8 @@
  *   📖 Secondary: https://swe-rebench.com (independent evals, scores are lower)
  *   📖 Leaderboard tracker: https://www.marc0.dev/en/leaderboard
  *
- *   @exports nvidiaNim, groq, cerebras, sambanova, openrouter, codestral, hyperbolic, scaleway, googleai — model arrays per provider
- *   @exports sources — map of { nvidia, groq, cerebras, sambanova, openrouter, codestral, hyperbolic, scaleway, googleai } each with { name, url, models }
+ *   @exports nvidiaNim, groq, cerebras, sambanova, openrouter, huggingface, replicate, deepinfra, fireworks, codestral, hyperbolic, scaleway, googleai — model arrays per provider
+ *   @exports sources — map of { nvidia, groq, cerebras, sambanova, openrouter, huggingface, replicate, deepinfra, fireworks, codestral, hyperbolic, scaleway, googleai } each with { name, url, models }
  *   @exports MODELS — flat array of [modelId, label, tier, sweScore, ctx, providerKey]
  *
  *   📖 MODELS now includes providerKey as 6th element so ping() knows which
@@ -139,13 +139,17 @@ export const sambanova = [
   ['Meta-Llama-3.3-70B-Instruct',          'Llama 3.3 70B',      'A-', '39.5%', '128k'],
   // ── B tier ──
   ['Meta-Llama-3.1-8B-Instruct',           'Llama 3.1 8B',       'B',  '28.8%', '128k'],
+  // ── A tier — requested Llama3-Groq coding tuned family ──
+  ['Llama-3-Groq-70B-Tool-Use',            'Llama3-Groq 70B',    'A',  '43.0%', '128k'],
 ]
 
 // 📖 OpenRouter source - https://openrouter.ai
 // 📖 Free :free models with shared quota — 50 free req/day
-// 📖 API keys at https://openrouter.ai/settings/keys
+// 📖 API keys at https://openrouter.ai/keys
 export const openrouter = [
-  ['qwen/qwen3-coder:free',                    'Qwen3 Coder',        'S+', '70.6%', '256k'],
+  ['qwen/qwen3-coder:480b-free',               'Qwen3 Coder 480B',   'S+', '70.6%', '256k'],
+  ['mistralai/devstral-2-free',                'Devstral 2',         'S+', '72.2%', '256k'],
+  ['mimo-v2-flash-free',                       'Mimo V2 Flash',      'A',  '45.0%', '128k'],
   ['stepfun/step-3.5-flash:free',              'Step 3.5 Flash',     'S+', '74.4%', '256k'],
   ['deepseek/deepseek-r1-0528:free',           'DeepSeek R1 0528',   'S',  '61.0%', '128k'],
   ['qwen/qwen3-next-80b-a3b-instruct:free',    'Qwen3 80B Instruct', 'S',  '65.0%', '128k'],
@@ -155,6 +159,35 @@ export const openrouter = [
   ['meta-llama/llama-3.3-70b-instruct:free',   'Llama 3.3 70B',      'A-', '39.5%', '128k'],
 ]
 
+// 📖 Hugging Face Inference source - https://huggingface.co
+// 📖 OpenAI-compatible endpoint via router.huggingface.co/v1
+// 📖 Free monthly credits on developer accounts (~$0.10) — token at https://huggingface.co/settings/tokens
+export const huggingface = [
+  ['deepseek-ai/DeepSeek-V3-Coder',            'DeepSeek V3 Coder',  'S',  '62.0%', '128k'],
+  ['bigcode/starcoder2-15b',                   'StarCoder2 15B',     'B',  '25.0%', '16k'],
+]
+
+// 📖 Replicate source - https://replicate.com
+// 📖 Uses predictions endpoint (not OpenAI chat-completions) with token auth
+export const replicate = [
+  ['codellama/CodeLlama-70b-Instruct-hf',      'CodeLlama 70B',      'A-', '39.0%', '16k'],
+]
+
+// 📖 DeepInfra source - https://deepinfra.com
+// 📖 OpenAI-compatible endpoint: https://api.deepinfra.com/v1/openai/chat/completions
+export const deepinfra = [
+  ['mistralai/Mixtral-8x22B-Instruct-v0.1',    'Mixtral Code',       'B+', '32.0%', '64k'],
+  ['meta-llama/Meta-Llama-3.1-70B-Instruct',   'Llama 3.1 70B',      'A-', '39.5%', '128k'],
+]
+
+// 📖 Fireworks AI source - https://fireworks.ai
+// 📖 OpenAI-compatible endpoint: https://api.fireworks.ai/inference/v1/chat/completions
+// 📖 Free trial credits: $1 for new developers
+export const fireworks = [
+  ['accounts/fireworks/models/deepseek-v3',    'DeepSeek V3',        'S',  '62.0%', '128k'],
+  ['accounts/fireworks/models/deepseek-r1',    'DeepSeek R1',        'S',  '61.0%', '128k'],
+]
+
 // 📖 Mistral Codestral source - https://codestral.mistral.ai
 // 📖 Free coding model — 30 req/min, 2000/day (phone number required for key)
 // 📖 API keys at https://codestral.mistral.ai
@@ -225,6 +258,26 @@ export const sources = {
     url: 'https://openrouter.ai/api/v1/chat/completions',
     models: openrouter,
   },
+  huggingface: {
+    name: 'Hugging Face',
+    url: 'https://router.huggingface.co/v1/chat/completions',
+    models: huggingface,
+  },
+  replicate: {
+    name: 'Replicate',
+    url: 'https://api.replicate.com/v1/predictions',
+    models: replicate,
+  },
+  deepinfra: {
+    name: 'DeepInfra',
+    url: 'https://api.deepinfra.com/v1/openai/chat/completions',
+    models: deepinfra,
+  },
+  fireworks: {
+    name: 'Fireworks',
+    url: 'https://api.fireworks.ai/inference/v1/chat/completions',
+    models: fireworks,
+  },
   codestral: {
     name: 'Codestral',
     url: 'https://codestral.mistral.ai/v1/chat/completions',