free-coding-models 0.1.62 → 0.1.64

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,10 +32,19 @@
  *       "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 }
+ *     },
+ *     "telemetry": {
+ *       "enabled": true,
+ *       "consentVersion": 1,
+ *       "anonymousId": "anon_550e8400-e29b-41d4-a716-446655440000"
  *     }
  *   }
  *
@@ -69,6 +82,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',
@@ -86,7 +103,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}> }}
+ * @returns {{ apiKeys: Record<string,string>, providers: Record<string,{enabled:boolean}>, telemetry: { enabled: boolean | null, consentVersion: number, anonymousId: string | null } }}
  */
 export function loadConfig() {
   // 📖 Try new JSON config first
@@ -97,6 +114,10 @@ export function loadConfig() {
       // 📖 Ensure the shape is always complete — fill missing sections with defaults
       if (!parsed.apiKeys) parsed.apiKeys = {}
       if (!parsed.providers) parsed.providers = {}
+      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
+      if (typeof parsed.telemetry.anonymousId !== 'string' || !parsed.telemetry.anonymousId.trim()) parsed.telemetry.anonymousId = null
       return parsed
     } catch {
       // 📖 Corrupted JSON — return empty config (user will re-enter keys)
@@ -129,7 +150,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}> }} config
+ * @param {{ apiKeys: Record<string,string>, providers: Record<string,{enabled:boolean}>, telemetry?: { enabled?: boolean | null, consentVersion?: number, anonymousId?: string | null } }} config
  */
 export function saveConfig(config) {
   try {
@@ -154,7 +175,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]
@@ -184,5 +208,11 @@ function _emptyConfig() {
   return {
     apiKeys: {},
     providers: {},
+    // 📖 Telemetry consent is explicit. null = not decided yet.
+    telemetry: {
+      enabled: null,
+      consentVersion: 0,
+      anonymousId: null,
+    },
   }
 }

package/lib/utils.js

@@ -277,11 +277,11 @@ export function findBestModel(results) {
 //
 // 📖 Argument types:
 //   - API key: first positional arg that doesn't start with "--" (e.g., "nvapi-xxx")
-//   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --openclaw (case-insensitive)
+//   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --openclaw, --no-telemetry (case-insensitive)
 //   - Value flag: --tier <letter> (the next non-flag arg is the tier value)
 //
 // 📖 Returns:
-//   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode, tierFilter }
+//   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode, noTelemetry, tierFilter }
 //
 // 📖 Note: apiKey may be null here — the main CLI falls back to env vars and saved config.
 export function parseArgs(argv) {
@@ -310,8 +310,9 @@ export function parseArgs(argv) {
   const openCodeMode = flags.includes('--opencode')
   const openCodeDesktopMode = flags.includes('--opencode-desktop')
   const openClawMode = flags.includes('--openclaw')
+  const noTelemetry = flags.includes('--no-telemetry')
 
   let tierFilter = tierValueIdx !== -1 ? args[tierValueIdx].toUpperCase() : null
 
-  return { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode, tierFilter }
+  return { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode, noTelemetry, tierFilter }
 }

package/package.json

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