Refactor/model configuration (#119)

- Add Abstract AIModel class
- Add generic implementations and capabilities interfaces
- Apply models in the code and add predefined cloud models
- Make TTS models implement ITTSModel
- Fix and add tests
- register test model before each test

Author: srebrek

Examples/Examples.SimpleConsole/Program.cs

@@ -1,12 +1,18 @@
 using MaIN.Core;
 using MaIN.Core.Hub;
+using MaIN.Domain.Models.Concrete;
 
 MaINBootstrapper.Initialize();
 
-var model = AIHub.Model();
+var modelContext = AIHub.Model();
 
-var m = model.GetModel("gemma3:4b");
-var x = model.GetModel("llama3.2:3b");
-await model.DownloadAsync(x.Name);
+// Get models using ModelRegistry
+var gemma = modelContext.GetModel("gemma3-4b");
+var llama = modelContext.GetModel("llama3.2-3b");
 
+// Or use strongly-typed models directly
+var gemma2b = new Gemma2_2b();
+Console.WriteLine($"Model: {gemma2b.Name}, File: {gemma2b.FileName}");
 
+// Download a model
+await modelContext.DownloadAsync(gemma2b.Id);

Examples/Examples/Chat/ChatCustomGrammarExample.cs

@@ -1,6 +1,7 @@
 using MaIN.Core.Hub;
 using MaIN.Domain.Entities;
 using MaIN.Domain.Models;
+using MaIN.Domain.Models.Concrete;
 using Grammar = MaIN.Domain.Models.Grammar;
 
 namespace Examples.Chat;
@@ -21,7 +22,7 @@ public async Task Start()
                                         """, GrammarFormat.GBNF);
 
         await AIHub.Chat()
-            .WithModel("gemma2:2b")
+            .WithModel<Gemma2_2b>()
             .WithMessage("Generate random person")
             .WithInferenceParams(new InferenceParams
             {

Examples/Examples/Chat/ChatExample.cs

@@ -1,4 +1,5 @@
 using MaIN.Core.Hub;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -8,8 +9,9 @@ public async Task Start()
     {
         Console.WriteLine("ChatExample is running!");
 
+        // Using strongly-typed model
         await AIHub.Chat()
-            .WithModel("gemma2:2b")
+            .WithModel<Gemma2_2b>()
             .WithMessage("Where do hedgehogs goes at night?")
             .CompleteAsync(interactive: true);
     }

Examples/Examples/Chat/ChatExampleAnthropic.cs

@@ -1,5 +1,6 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -11,7 +12,7 @@ public async Task Start()
         Console.WriteLine("(Anthropic) ChatExample is running!");
 
         await AIHub.Chat()
-            .WithModel("claude-sonnet-4-20250514")
+            .WithModel<ClaudeSonnet4>()
             .WithMessage("Write a haiku about programming on Monday morning.")
             .CompleteAsync(interactive: true);
     }

Examples/Examples/Chat/ChatExampleGemini.cs

@@ -1,5 +1,8 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
+using MaIN.Domain.Configuration;
+using MaIN.Domain.Models.Abstract;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -10,9 +13,18 @@ public async Task Start()
         GeminiExample.Setup(); //We need to provide Gemini API key
         Console.WriteLine("(Gemini) ChatExample is running!");
 
+        // Get built-in Gemini 2.5 Flash model
+        var model = AIHub.Model().GetModel(new Gemini2_5Flash().Id);
+
+        // Or create the model manually if not available in the hub
+        var customModel = new GenericCloudModel(
+            "gemini-2.5-flash",
+            BackendType.Gemini
+        );
+
         await AIHub.Chat()
-            .WithModel("gemini-2.5-flash")
+            .WithModel(customModel)
             .WithMessage("Is the killer whale the smartest animal?")
             .CompleteAsync(interactive: true);
     }
-}
+}

Examples/Examples/Chat/ChatExampleGroqCloud.cs

@@ -1,5 +1,6 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -11,7 +12,7 @@ public async Task Start()
         Console.WriteLine("(GroqCloud) ChatExample is running!");
 
         await AIHub.Chat()
-            .WithModel("llama-3.1-8b-instant")
+            .WithModel<Llama3_1_8bInstant>()
             .WithMessage("Which color do people like the most?")
             .CompleteAsync(interactive: true);
     }

Examples/Examples/Chat/ChatExampleOllama.cs

@@ -1,5 +1,6 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -11,7 +12,7 @@ public async Task Start()
         Console.WriteLine("(Ollama) ChatExample is running!");
 
         await AIHub.Chat()
-            .WithModel("gemma3:4b")
+            .WithModel<OllamaGemma3_4b>()
             .WithMessage("Write a short poem about the color green.")
             .CompleteAsync(interactive: true);
     }

Examples/Examples/Chat/ChatExampleOpenAi.cs

@@ -1,5 +1,6 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -12,7 +13,7 @@ public async Task Start()
         Console.WriteLine("(OpenAi) ChatExample is running!"); 
 
         await AIHub.Chat()
-            .WithModel("gpt-5-nano")
+            .WithModel<Gpt5Nano>()
             .WithMessage("What do you consider to be the greatest invention in history?")
             .CompleteAsync(interactive: true);
     }

Examples/Examples/Chat/ChatExampleToolsSimple.cs

@@ -1,6 +1,7 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
 using MaIN.Core.Hub.Utils;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -13,7 +14,7 @@ public async Task Start()
         Console.WriteLine("(OpenAi) ChatExample with tools is running!");
 
         await AIHub.Chat()
-            .WithModel("gpt-5-nano")
+            .WithModel<Gpt5Nano>()
             .WithMessage("What time is it right now?")
             .WithTools(new ToolsConfigurationBuilder()
                 .AddTool(

Examples/Examples/Chat/ChatExampleToolsSimpleLocalLLM.cs

@@ -1,6 +1,7 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
 using MaIN.Core.Hub.Utils;
+using MaIN.Domain.Models.Concrete;
 
 namespace Examples.Chat;
 
@@ -11,7 +12,7 @@ public async Task Start()
         Console.WriteLine("Local LLM ChatExample with tools is running!");
 
         await AIHub.Chat()
-            .WithModel("gemma3:4b")
+            .WithModel<Gemma3_4b>()
             .WithMessage("What time is it right now?")
             .WithTools(new ToolsConfigurationBuilder()
                 .AddTool(