noosphere 0.2.2 → 0.3.0

package/README.md

@@ -63,6 +63,56 @@ const audio = await ai.speak({
 
 Noosphere **automatically discovers the latest models from EVERY provider's API at runtime** — across **all 4 modalities** (LLM, image, video, TTS). When Google releases a new Gemini model, when OpenAI drops GPT-5, when FAL adds a new video model, when a new image model trends on HuggingFace — **you get them immediately**, without updating Noosphere or any dependency.
 
+### Provider Logos — SVG & PNG for Every Model
+
+Every model returned by the auto-fetch includes a `logo` field with the provider's official logo in SVG and PNG formats. For aggregator providers (OpenRouter, HuggingFace), logos are resolved to the **real upstream provider** — so an `x-ai/grok-4` model gets the xAI logo, not OpenRouter's.
+
+```typescript
+const models = await ai.getModels('llm');
+
+for (const model of models) {
+  console.log(model.id, model.logo);
+  // "gpt-5" { svg: "https://cdn.simpleicons.org/openai", png: "https://cdn.brandfetch.io/.../icon.png" }
+  // "claude-opus-4-6" { svg: "https://cdn.simpleicons.org/anthropic", png: "https://cdn.brandfetch.io/.../icon.png" }
+  // "gemini-2.5-pro" { svg: "https://cdn.simpleicons.org/google", png: "https://cdn.brandfetch.io/.../icon.png" }
+}
+
+// Providers also have logos:
+const providers = await ai.getProviders();
+providers.forEach(p => console.log(p.id, p.logo));
+
+// Use in your UI:
+// <img src={model.logo.svg} alt={model.provider} />
+```
+
+**Covered providers:** OpenAI, Anthropic, Google, Groq, Mistral, xAI, OpenRouter, Cerebras, Meta, DeepSeek, Microsoft, NVIDIA, Qwen, Cohere, Perplexity, Amazon, FAL, HuggingFace, ComfyUI, Piper, Kokoro, Ollama, SambaNova, Together, Fireworks, Replicate, Nebius, Novita.
+
+You can also import the logo registry directly:
+
+```typescript
+import { getProviderLogo, PROVIDER_LOGOS } from 'noosphere';
+
+const logo = getProviderLogo('anthropic');
+// { svg: "https://cdn.simpleicons.org/anthropic", png: "https://cdn.brandfetch.io/.../icon.png" }
+
+// Or access the full map:
+console.log(Object.keys(PROVIDER_LOGOS));
+// ['openai', 'anthropic', 'google', 'groq', 'mistral', 'xai', 'openrouter', ...]
+```
+
+For HuggingFace models with multiple inference providers, per-provider logos are available in `capabilities.inferenceProviderLogos`:
+
+```typescript
+const hfModels = await ai.getModels('llm');
+const qwen = hfModels.find(m => m.id === 'Qwen/Qwen2.5-72B-Instruct');
+
+console.log(qwen.capabilities.inferenceProviderLogos);
+// {
+//   "together": { svg: "https://cdn.simpleicons.org/togetherai", png: "..." },
+//   "fireworks-ai": { png: "https://cdn.brandfetch.io/.../icon.png" },
+// }
+```
+
 ### The Problem It Solves
 
 Traditional AI libraries rely on **static model catalogs** hardcoded at build time. The `@mariozechner/pi-ai` dependency ships with ~246 LLM models in a pre-generated `models.generated.js` file. HuggingFace providers typically hardcode 3-5 default models. When a provider releases a new model, you'd have to wait for the library maintainer to update, publish, and then you'd `npm update`. This lag can be days or weeks.

package/dist/index.cjs

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Noosphere: () => Noosphere,
-  NoosphereError: () => NoosphereError
+  NoosphereError: () => NoosphereError,
+  PROVIDER_LOGOS: () => PROVIDER_LOGOS,
+  getProviderLogo: () => getProviderLogo
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -53,6 +55,16 @@ var NoosphereError = class extends Error {
 };
 
 // src/config.ts
+var _envLoaded = false;
+function loadEnv() {
+  if (_envLoaded) return;
+  _envLoaded = true;
+  try {
+    const dotenvx = require("@dotenvx/dotenvx");
+    dotenvx.config({ quiet: true });
+  } catch {
+  }
+}
 var ENV_KEY_MAP = {
   openai: "OPENAI_API_KEY",
   anthropic: "ANTHROPIC_API_KEY",
@@ -76,6 +88,7 @@ var DEFAULT_RETRYABLE = [
   "TIMEOUT"
 ];
 function resolveConfig(input) {
+  loadEnv();
   const keys = {};
   for (const [name, envVar] of Object.entries(ENV_KEY_MAP)) {
     keys[name] = input.keys?.[name] ?? process.env[envVar];
@@ -117,6 +130,132 @@ function resolveConfig(input) {
   };
 }
 
+// src/logos.ts
+var PROVIDER_LOGOS = {
+  // --- Cloud LLM Providers ---
+  openai: {
+    svg: "https://cdn.simpleicons.org/openai",
+    png: "https://cdn.brandfetch.io/idR3duQxYl/w/512/h/512/theme/dark/icon.png"
+  },
+  anthropic: {
+    svg: "https://cdn.simpleicons.org/anthropic",
+    png: "https://cdn.brandfetch.io/id2S-kXbuM/w/512/h/512/theme/dark/icon.png"
+  },
+  google: {
+    svg: "https://cdn.simpleicons.org/google",
+    png: "https://cdn.brandfetch.io/id6O2oGzv-/w/512/h/512/theme/dark/icon.png"
+  },
+  groq: {
+    svg: "https://cdn.simpleicons.org/groq",
+    png: "https://cdn.brandfetch.io/idTEBPz5KO/w/512/h/512/theme/dark/icon.png"
+  },
+  mistral: {
+    svg: "https://cdn.simpleicons.org/mistral",
+    png: "https://cdn.brandfetch.io/idnBOFq5eF/w/512/h/512/theme/dark/icon.png"
+  },
+  xai: {
+    svg: "https://cdn.simpleicons.org/x",
+    png: "https://cdn.brandfetch.io/idS5WhqBbM/w/512/h/512/theme/dark/icon.png"
+  },
+  openrouter: {
+    svg: "https://openrouter.ai/favicon.svg",
+    png: "https://openrouter.ai/favicon.png"
+  },
+  cerebras: {
+    svg: "https://cdn.simpleicons.org/cerebras",
+    png: "https://cdn.brandfetch.io/idGa4PRFP0/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- Media Providers ---
+  fal: {
+    svg: "https://fal.ai/favicon.svg",
+    png: "https://fal.ai/favicon.png"
+  },
+  huggingface: {
+    svg: "https://cdn.simpleicons.org/huggingface",
+    png: "https://cdn.brandfetch.io/idnrPPHe87/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- Local Providers ---
+  comfyui: {
+    svg: "https://raw.githubusercontent.com/comfyanonymous/ComfyUI/master/web/assets/icon.svg",
+    png: "https://raw.githubusercontent.com/comfyanonymous/ComfyUI/master/web/assets/icon.png"
+  },
+  piper: {
+    png: "https://raw.githubusercontent.com/rhasspy/piper/master/logo.png"
+  },
+  kokoro: {
+    png: "https://raw.githubusercontent.com/hexgrad/kokoro/main/assets/icon.png"
+  },
+  ollama: {
+    svg: "https://cdn.simpleicons.org/ollama",
+    png: "https://cdn.brandfetch.io/idtesMoSFj/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- Model Org Providers (from OpenRouter model prefixes) ---
+  meta: {
+    svg: "https://cdn.simpleicons.org/meta",
+    png: "https://cdn.brandfetch.io/idmKk_rq7Y/w/512/h/512/theme/dark/icon.png"
+  },
+  deepseek: {
+    png: "https://cdn.brandfetch.io/id1BWKUVWI/w/512/h/512/theme/dark/icon.png"
+  },
+  microsoft: {
+    svg: "https://cdn.simpleicons.org/microsoft",
+    png: "https://cdn.brandfetch.io/idchmboHEZ/w/512/h/512/theme/dark/icon.png"
+  },
+  nvidia: {
+    svg: "https://cdn.simpleicons.org/nvidia",
+    png: "https://cdn.brandfetch.io/id1JcGHuZN/w/512/h/512/theme/dark/icon.png"
+  },
+  qwen: {
+    png: "https://img.alicdn.com/imgextra/i1/O1CN01BUp2gU1sRZigvazUo_!!6000000005764-2-tps-228-228.png"
+  },
+  cohere: {
+    svg: "https://cdn.simpleicons.org/cohere",
+    png: "https://cdn.brandfetch.io/idiDnz1fvB/w/512/h/512/theme/dark/icon.png"
+  },
+  perplexity: {
+    svg: "https://cdn.simpleicons.org/perplexity",
+    png: "https://cdn.brandfetch.io/idwWX3Neii/w/512/h/512/theme/dark/icon.png"
+  },
+  amazon: {
+    svg: "https://cdn.simpleicons.org/amazonaws",
+    png: "https://cdn.brandfetch.io/idawORoPJZ/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- HuggingFace Inference Providers ---
+  "hf-inference": {
+    svg: "https://cdn.simpleicons.org/huggingface",
+    png: "https://cdn.brandfetch.io/idnrPPHe87/w/512/h/512/theme/dark/icon.png"
+  },
+  "sambanova": {
+    png: "https://cdn.brandfetch.io/id__2e5yMY/w/512/h/512/theme/dark/icon.png"
+  },
+  "together": {
+    svg: "https://cdn.simpleicons.org/togetherai",
+    png: "https://cdn.brandfetch.io/idH5EoFVaH/w/512/h/512/theme/dark/icon.png"
+  },
+  "fireworks-ai": {
+    png: "https://cdn.brandfetch.io/idj1VQ2O4C/w/512/h/512/theme/dark/icon.png"
+  },
+  "replicate": {
+    svg: "https://cdn.simpleicons.org/replicate",
+    png: "https://cdn.brandfetch.io/idWKE4rRaH/w/512/h/512/theme/dark/icon.png"
+  },
+  "nebius": {
+    png: "https://cdn.brandfetch.io/idiUqSQ52b/w/512/h/512/theme/dark/icon.png"
+  },
+  "novita": {
+    png: "https://novita.ai/favicon.png"
+  }
+};
+function getProviderLogo(providerId) {
+  if (!providerId) return void 0;
+  if (PROVIDER_LOGOS[providerId]) return PROVIDER_LOGOS[providerId];
+  const normalized = providerId.toLowerCase().replace(/[-_\s]/g, "");
+  for (const [key, logo] of Object.entries(PROVIDER_LOGOS)) {
+    if (key.replace(/[-_\s]/g, "") === normalized) return logo;
+  }
+  return void 0;
+}
+
 // src/registry.ts
 var Registry = class {
   providers = /* @__PURE__ */ new Map();
@@ -220,7 +359,8 @@ var Registry = class {
         local: provider.isLocal,
         status: "online",
         // ping-based status is set externally
-        modelCount: cached?.models.length ?? 0
+        modelCount: cached?.models.length ?? 0,
+        logo: getProviderLogo(provider.id)
       });
     }
     return infos;
@@ -420,6 +560,8 @@ var PiAiProvider = class {
     await this.ensureDynamicModels();
     const models = [];
     for (const [, m] of this.dynamicModels) {
+      const providerName = String(m.provider);
+      const logoProvider = this.inferLogoProvider(m.id, providerName);
       models.push({
         id: m.id,
         provider: "pi-ai",
@@ -430,6 +572,7 @@ var PiAiProvider = class {
           price: m.cost.input ?? 0,
           unit: m.cost.input > 0 ? "per_1m_tokens" : "free"
         },
+        logo: getProviderLogo(logoProvider),
         capabilities: {
           contextWindow: m.contextWindow,
           maxTokens: m.maxTokens,
@@ -621,6 +764,42 @@ var PiAiProvider = class {
     this.dynamicModels.clear();
     await this.ensureDynamicModels();
   }
+  /**
+   * Infer the real provider from model ID for logo resolution.
+   * e.g. "x-ai/grok-4" → "xai", "anthropic/claude-4" → "anthropic"
+   */
+  inferLogoProvider(modelId, fallback) {
+    const MODEL_PREFIX_TO_PROVIDER = {
+      "openai/": "openai",
+      "gpt-": "openai",
+      "o1-": "openai",
+      "o3-": "openai",
+      "o4-": "openai",
+      "chatgpt-": "openai",
+      "anthropic/": "anthropic",
+      "claude-": "anthropic",
+      "google/": "google",
+      "gemini-": "google",
+      "gemma-": "google",
+      "x-ai/": "xai",
+      "grok-": "xai",
+      "meta-llama/": "meta",
+      "mistralai/": "mistral",
+      "mistral-": "mistral",
+      "deepseek/": "deepseek",
+      "microsoft/": "microsoft",
+      "nvidia/": "nvidia",
+      "qwen/": "qwen",
+      "cohere/": "cohere",
+      "perplexity/": "perplexity",
+      "amazon/": "amazon"
+    };
+    const lower = modelId.toLowerCase();
+    for (const [prefix, provider] of Object.entries(MODEL_PREFIX_TO_PROVIDER)) {
+      if (lower.startsWith(prefix)) return provider;
+    }
+    return fallback;
+  }
   findModel(modelId) {
     if (modelId) {
       const dynamic = this.dynamicModels.get(modelId);
@@ -680,7 +859,8 @@ var FalProvider = class {
           name: entry.modelId.replace("fal-ai/", ""),
           modality: inferredModality,
           local: false,
-          cost: { price: entry.price, unit: entry.unit }
+          cost: { price: entry.price, unit: entry.unit },
+          logo: getProviderLogo("fal")
         });
       }
       return models;
@@ -833,6 +1013,7 @@ var ComfyUIProvider = class {
       const res = await fetch(`${this.baseUrl}/object_info`);
       if (!res.ok) return [];
       const models = [];
+      const logo = getProviderLogo("comfyui");
       if (!modality || modality === "image") {
         models.push({
           id: "comfyui-txt2img",
@@ -841,6 +1022,7 @@ var ComfyUIProvider = class {
           modality: "image",
           local: true,
           cost: { price: 0, unit: "free" },
+          logo,
           capabilities: { maxWidth: 2048, maxHeight: 2048, supportsNegativePrompt: true }
         });
       }
@@ -852,6 +1034,7 @@ var ComfyUIProvider = class {
           modality: "video",
           local: true,
           cost: { price: 0, unit: "free" },
+          logo,
           capabilities: { maxDuration: 10, supportsImageToVideo: true }
         });
       }
@@ -963,6 +1146,7 @@ var LocalTTSProvider = class {
           voices = data.data ?? [];
         }
       }
+      const logo = getProviderLogo(this.id);
       return voices.map((v) => ({
         id: v.id,
         provider: this.id,
@@ -970,6 +1154,7 @@ var LocalTTSProvider = class {
         modality: "tts",
         local: true,
         cost: { price: 0, unit: "free" },
+        logo,
         capabilities: { voices: voices.map((vv) => vv.id) }
       }));
     } catch {
@@ -1080,7 +1265,13 @@ var HuggingFaceProvider = class {
         const data = await res.json();
         return data.filter((entry) => entry.id || entry.modelId).map((entry) => {
           const id = entry.id ?? entry.modelId;
-          const providers = (entry.inferenceProviderMapping ?? []).filter((p) => p.status === "live").map((p) => p.provider);
+          const liveProviders = (entry.inferenceProviderMapping ?? []).filter((p) => p.status === "live");
+          const providers = liveProviders.map((p) => p.provider);
+          const inferenceProviderLogos = {};
+          for (const p of liveProviders) {
+            const pLogo = getProviderLogo(p.provider);
+            if (pLogo) inferenceProviderLogos[p.provider] = pLogo;
+          }
           const pricingProvider = (entry.inferenceProviderMapping ?? []).find((p) => p.providerDetails?.pricing);
           const pricing = pricingProvider?.providerDetails?.pricing;
           const contextLength = (entry.inferenceProviderMapping ?? []).find((p) => p.providerDetails?.context_length)?.providerDetails?.context_length;
@@ -1094,12 +1285,14 @@ var HuggingFaceProvider = class {
               price: pricing?.input ?? 0,
               unit: pricing ? "per_1m_tokens" : "free"
             },
+            logo: getProviderLogo("huggingface"),
             capabilities: {
               ...modality === "llm" ? {
                 contextWindow: contextLength,
                 supportsStreaming: true
               } : {},
-              ...providers.length > 0 ? { inferenceProviders: providers } : {}
+              ...providers.length > 0 ? { inferenceProviders: providers } : {},
+              ...Object.keys(inferenceProviderLogos).length > 0 ? { inferenceProviderLogos } : {}
             }
           };
         });
@@ -1551,6 +1744,8 @@ var Noosphere = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Noosphere,
-  NoosphereError
+  NoosphereError,
+  PROVIDER_LOGOS,
+  getProviderLogo
 });
 //# sourceMappingURL=index.cjs.map