Added Hugging Face inference provider (#397)

app/MindWork AI Studio/Provider/LLMProvidersExtensions.cs

@@ -6,6 +6,7 @@ using AIStudio.Provider.Google;
 using AIStudio.Provider.Groq;
 using AIStudio.Provider.GWDG;
 using AIStudio.Provider.Helmholtz;
+using AIStudio.Provider.HuggingFace;
 using AIStudio.Provider.Mistral;
 using AIStudio.Provider.OpenAI;
 using AIStudio.Provider.SelfHosted;
@@ -37,6 +38,7 @@ public static class LLMProvidersExtensions
         
         LLMProviders.GROQ => "Groq",
         LLMProviders.FIREWORKS => "Fireworks.ai",
+        LLMProviders.HUGGINGFACE => "Hugging Face",
         
         LLMProviders.SELF_HOSTED => "Self-hosted",
         
@@ -56,7 +58,10 @@ public static class LLMProvidersExtensions
     {
         LLMProviders.NONE => Confidence.NONE,
         
-        LLMProviders.FIREWORKS => Confidence.USA_NOT_TRUSTED.WithRegion("America, U.S.").WithSources("https://fireworks.ai/terms-of-service").WithLevel(settingsManager.GetConfiguredConfidenceLevel(llmProvider)),
+        LLMProviders.FIREWORKS => Confidence.USA_HUB.WithRegion("America, U.S.").WithSources("https://fireworks.ai/terms-of-service").WithLevel(settingsManager.GetConfiguredConfidenceLevel(llmProvider)),
+        
+        // Not trusted, because huggingface only routes you to a third-party-provider and we can't make sure they do not use your data 
+        LLMProviders.HUGGINGFACE => Confidence.USA_HUB.WithRegion("America, U.S.").WithSources("https://huggingface.co/terms-of-service").WithLevel(settingsManager.GetConfiguredConfidenceLevel(llmProvider)), 
         
         LLMProviders.OPEN_AI => Confidence.USA_NO_TRAINING.WithRegion("America, U.S.").WithSources(
             "https://platform.openai.com/docs/models/default-usage-policies-by-endpoint",
@@ -112,6 +117,7 @@ public static class LLMProvidersExtensions
         LLMProviders.X => false,
         LLMProviders.GWDG => false,
         LLMProviders.DEEP_SEEK => false,
+        LLMProviders.HUGGINGFACE => false,
         
         //
         // Self-hosted providers are treated as a special case anyway.
@@ -129,7 +135,7 @@ public static class LLMProvidersExtensions
     /// <returns>The provider instance.</returns>
     public static IProvider CreateProvider(this AIStudio.Settings.Provider providerSettings, ILogger logger)
     {
-        return providerSettings.UsedLLMProvider.CreateProvider(providerSettings.InstanceName, providerSettings.Host, providerSettings.Hostname, logger);
+        return providerSettings.UsedLLMProvider.CreateProvider(providerSettings.InstanceName, providerSettings.Host, providerSettings.Hostname, providerSettings.Model, providerSettings.HFInstanceProvider ,logger);
     }
     
     /// <summary>
@@ -140,10 +146,10 @@ public static class LLMProvidersExtensions
     /// <returns>The provider instance.</returns>
     public static IProvider CreateProvider(this EmbeddingProvider embeddingProviderSettings, ILogger logger)
     {
-        return embeddingProviderSettings.UsedLLMProvider.CreateProvider(embeddingProviderSettings.Name, embeddingProviderSettings.Host, embeddingProviderSettings.Hostname, logger);
+        return embeddingProviderSettings.UsedLLMProvider.CreateProvider(embeddingProviderSettings.Name, embeddingProviderSettings.Host, embeddingProviderSettings.Hostname, embeddingProviderSettings.Model, HFInstanceProvider.NONE,logger);
     }
     
-    private static IProvider CreateProvider(this LLMProviders provider, string instanceName, Host host, string hostname, ILogger logger)
+    private static IProvider CreateProvider(this LLMProviders provider, string instanceName, Host host, string hostname, Model model, HFInstanceProvider instanceProvider , ILogger logger)
     {
         try
         {
@@ -159,6 +165,7 @@ public static class LLMProvidersExtensions
                 
                 LLMProviders.GROQ => new ProviderGroq(logger) { InstanceName = instanceName },
                 LLMProviders.FIREWORKS => new ProviderFireworks(logger) { InstanceName = instanceName },
+                LLMProviders.HUGGINGFACE => new ProviderHuggingFace(logger, instanceProvider, model) { InstanceName = instanceName }, 
                 
                 LLMProviders.SELF_HOSTED => new ProviderSelfHosted(logger, host, hostname) { InstanceName = instanceName },
                 
@@ -187,6 +194,7 @@ public static class LLMProvidersExtensions
      
         LLMProviders.GROQ => "https://console.groq.com/",
         LLMProviders.FIREWORKS => "https://fireworks.ai/login",
+        LLMProviders.HUGGINGFACE => "https://huggingface.co/login",
         
         LLMProviders.HELMHOLTZ => "https://sdlaml.pages.jsc.fz-juelich.de/ai/guides/blablador_api_access/#step-1-register-on-gitlab",
         LLMProviders.GWDG => "https://docs.hpc.gwdg.de/services/saia/index.html#api-request",
@@ -205,6 +213,7 @@ public static class LLMProvidersExtensions
         LLMProviders.FIREWORKS => "https://fireworks.ai/account/billing",
         LLMProviders.DEEP_SEEK => "https://platform.deepseek.com/usage",
         LLMProviders.ALIBABA_CLOUD => "https://usercenter2-intl.aliyun.com/billing",
+        LLMProviders.HUGGINGFACE => "https://huggingface.co/settings/billing",
         
         _ => string.Empty,
     };
@@ -220,19 +229,22 @@ public static class LLMProvidersExtensions
         LLMProviders.GOOGLE => true,
         LLMProviders.DEEP_SEEK => true,
         LLMProviders.ALIBABA_CLOUD => true,
+        LLMProviders.HUGGINGFACE => true,
         
         _ => false,
     };
 
-    public static string GetModelsOverviewURL(this LLMProviders provider) => provider switch
+    public static string GetModelsOverviewURL(this LLMProviders provider, HFInstanceProvider instanceProvider) => provider switch
     {
         LLMProviders.FIREWORKS => "https://fireworks.ai/models?show=Serverless",
+        LLMProviders.HUGGINGFACE => $"https://huggingface.co/models?inference_provider={instanceProvider.EndpointsId()}",
         _ => string.Empty,
     };
 
     public static bool IsLLMModelProvidedManually(this LLMProviders provider) => provider switch
     {
         LLMProviders.FIREWORKS => true,
+        LLMProviders.HUGGINGFACE => true,
         _ => false,
     };
     
@@ -268,6 +280,7 @@ public static class LLMProvidersExtensions
         LLMProviders.FIREWORKS => true,
         LLMProviders.HELMHOLTZ => true,
         LLMProviders.GWDG => true,
+        LLMProviders.HUGGINGFACE => true,
         
         LLMProviders.SELF_HOSTED => host is Host.OLLAMA,
         
@@ -288,6 +301,7 @@ public static class LLMProvidersExtensions
         LLMProviders.FIREWORKS => true,
         LLMProviders.HELMHOLTZ => true,
         LLMProviders.GWDG => true,
+        LLMProviders.HUGGINGFACE => true,
         
         _ => false,
     };
@@ -317,4 +331,10 @@ public static class LLMProvidersExtensions
         
         return true;
     }
+    
+    public static bool IsHFInstanceProviderNeeded(this LLMProviders provider) => provider switch
+    {
+        LLMProviders.HUGGINGFACE => true,
+        _ => false,
+    };
 }