Merge pull request #4 from guillaumegay13/codex/awesome-free-llm-providers

feat: add free-tier provider discovery

Author: guillaumegay13

.changeset/free-tier-providers.md

@@ -0,0 +1,5 @@
+---
+"manifest": patch
+---
+
+Add dynamic discovery and routing support for Cohere, Cerebras, Cloudflare Workers AI, GitHub Models, Groq, Hugging Face, LLM7.io, and Ollama Cloud.

packages/backend/src/common/constants/providers.spec.ts

@@ -9,8 +9,8 @@ import {
 } from './providers';
 
 describe('PROVIDER_REGISTRY', () => {
-  it('should contain exactly 13 provider entries', () => {
-    expect(PROVIDER_REGISTRY).toHaveLength(13);
+  it('should contain exactly 21 provider entries', () => {
+    expect(PROVIDER_REGISTRY).toHaveLength(21);
   });
 
   it('every entry has all required fields', () => {
@@ -72,11 +72,11 @@ describe('PROVIDER_REGISTRY', () => {
 });
 
 describe('PROVIDER_BY_ID', () => {
-  it('resolves all 13 provider IDs', () => {
+  it('resolves all 21 provider IDs', () => {
     for (const entry of PROVIDER_REGISTRY) {
       expect(PROVIDER_BY_ID.get(entry.id)).toBe(entry);
     }
-    expect(PROVIDER_BY_ID.size).toBe(13);
+    expect(PROVIDER_BY_ID.size).toBe(21);
   });
 
   it('returns undefined for an unknown ID', () => {
@@ -118,6 +118,13 @@ describe('PROVIDER_BY_ID_OR_ALIAS', () => {
     expect(entry.displayName).toBe('Z.ai');
   });
 
+  it('resolves github models alias to github-models entry', () => {
+    const entry = PROVIDER_BY_ID_OR_ALIAS.get('github models') as ProviderRegistryEntry;
+    expect(entry).toBeDefined();
+    expect(entry.id).toBe('github-models');
+    expect(entry.displayName).toBe('GitHub Models');
+  });
+
   it('returns undefined for an unknown alias', () => {
     expect(PROVIDER_BY_ID_OR_ALIAS.get('nonexistent')).toBeUndefined();
   });

packages/backend/src/common/constants/providers.ts

@@ -45,6 +45,30 @@ export const PROVIDER_REGISTRY: readonly ProviderRegistryEntry[] = [
     requiresApiKey: true,
     localOnly: false,
   },
+  {
+    id: 'cerebras',
+    displayName: 'Cerebras',
+    aliases: [],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
+  {
+    id: 'cloudflare',
+    displayName: 'Cloudflare Workers AI',
+    aliases: ['cloudflare workers ai'],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
+  {
+    id: 'cohere',
+    displayName: 'Cohere',
+    aliases: [],
+    openRouterPrefixes: ['cohere'],
+    requiresApiKey: true,
+    localOnly: false,
+  },
   {
     id: 'openai',
     displayName: 'OpenAI',
@@ -53,6 +77,14 @@ export const PROVIDER_REGISTRY: readonly ProviderRegistryEntry[] = [
     requiresApiKey: true,
     localOnly: false,
   },
+  {
+    id: 'github-models',
+    displayName: 'GitHub Models',
+    aliases: ['github models', 'githubmodels'],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
   {
     id: 'gemini',
     displayName: 'Google',
@@ -69,6 +101,30 @@ export const PROVIDER_REGISTRY: readonly ProviderRegistryEntry[] = [
     requiresApiKey: true,
     localOnly: false,
   },
+  {
+    id: 'groq',
+    displayName: 'Groq',
+    aliases: [],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
+  {
+    id: 'huggingface',
+    displayName: 'Hugging Face',
+    aliases: ['hugging face', 'hf'],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
+  {
+    id: 'llm7',
+    displayName: 'LLM7.io',
+    aliases: ['llm7.io'],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
   {
     id: 'mistral',
     displayName: 'Mistral',
@@ -141,6 +197,14 @@ export const PROVIDER_REGISTRY: readonly ProviderRegistryEntry[] = [
     requiresApiKey: false,
     localOnly: true,
   },
+  {
+    id: 'ollama-cloud',
+    displayName: 'Ollama Cloud',
+    aliases: ['ollama cloud'],
+    openRouterPrefixes: [],
+    requiresApiKey: true,
+    localOnly: false,
+  },
 ] as const;
 
 /* ── Derived lookup maps (computed once at import time) ── */

packages/backend/src/routing/model-discovery/model-discovery.service.ts

@@ -155,15 +155,19 @@ export class ModelDiscoveryService {
       if (!Array.isArray(cached)) continue;
       const providerAuthType = p.auth_type === 'subscription' ? 'subscription' : 'api_key';
       for (const m of cached) {
-        const effectiveAuthType = m.authType ?? providerAuthType;
+        const normalized = {
+          ...m,
+          authType: m.authType ?? providerAuthType,
+        };
+        const effectiveAuthType = normalized.authType ?? providerAuthType;
         if (!seen.has(m.id)) {
           seen.set(m.id, models.length);
-          models.push(m);
+          models.push(normalized);
         } else if (
           effectiveAuthType === 'subscription' &&
           models[seen.get(m.id)!]?.authType !== 'subscription'
         ) {
-          models[seen.get(m.id)!] = m;
+          models[seen.get(m.id)!] = normalized;
         }
       }
     }