Merge pull request #6 from wisedev-code/feat/implement_base_for_package

Feat/implement base for package

Author: wisedev-pstach

.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+name: Build, Test, and Publish NuGet Package
+
+on:
+  push:
+    branches:
+      - main
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v3
+        with:
+          dotnet-version: '8.0.x' # Change to your project’s .NET version
+
+      - name: Restore dependencies
+        run: dotnet restore
+
+      - name: Build solution
+        run: dotnet build --configuration Release --no-restore
+
+      - name: Run tests
+        run: dotnet test --configuration Release --no-build --verbosity normal
+
+      - name: Pack NuGet package
+        run: dotnet pack --configuration Release --output ./artifacts
+
+      - name: Push package to NuGet
+        env:
+          NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
+        run: dotnet nuget push "./artifacts/*.nupkg" --source "https://api.nuget.org/v3/index.json" --api-key "$NUGET_API_KEY" --skip-duplicate
+
+      - name: Create GitHub Release
+        if: github.ref == 'refs/heads/main'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          TAG_NAME="v$(date +'%Y.%m.%d')"
+          gh release create "$TAG_NAME" ./artifacts/*.nupkg --title "Release $TAG_NAME" --notes "Automated release of NuGet package."
+        shell: bash

.models

@@ -1,3 +1,10 @@
-
+gemma2-2b-maIN
+Nomic-maIN
+phi3.5-maIN
+Llama3.2-maIN
+Llava-maIN
+Llama3.1-maIN
+Qwen2.5-maIN
+DeepSeekR1-8b-maIN
 #Place any new model here and it will be downloaded during start command
 

Examples/Examples/Agents/AgentExample.cs

@@ -0,0 +1,36 @@
+using MaIN.Core.Hub;
+
+namespace Examples.Agents;
+
+public class AgentExample : IExample
+{
+    public async Task Start()
+    {
+        Console.WriteLine("Basic agent example is running!");
+
+        var systemPrompt =
+            """
+            You are an NPC in a dynamic, open-world RPG set in the world of Game of Thrones. 
+            Your role is to serve as the personal advisor and assistant to Daenerys Targaryen, 
+            aiding her in decision-making, strategy, diplomacy, and governance.
+            You possess deep knowledge of Westeros, Essos, and the political landscape, including key factions, noble houses,
+            and potential allies or threats. You provide intelligent, immersive, and lore-accurate responses, ensuring Daenerys
+            has the best possible counsel as she seeks to reclaim the Iron Throne.
+            Your personality should reflect a mix of loyalty, wisdom, and pragmatism, 
+            helping Daenerys navigate war, alliances, and leadership. 
+            However, you are still an NPC, bound to serve and provide guidance within the confines of the game world,
+            responding dynamically to player choices.\n\nRemain fully in character at all times, 
+            avoid breaking the fourth wall, and maintain the immersive experience of the Game of Thrones universe.
+            """;
+
+        var context = AIHub.Agent()
+            .WithModel("llama3.2:3b")
+            .WithInitialPrompt(systemPrompt)
+            .Create();
+        
+        var result = await context
+            .ProcessAsync("Where is the Iron Throne located? I need this information for Lady Princess");
+
+        Console.WriteLine(result.Message.Content);
+    }
+}

Examples/Examples/Agents/AgentWithApiDataSourceExample.cs

@@ -0,0 +1,34 @@
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+using MaIN.Domain.Entities.Agents.AgentSource;
+
+namespace Examples.Agents;
+
+public class AgentWithApiDataSourceExample : IExample
+{
+    public async Task Start()
+    {
+        Console.WriteLine("Agent with api source");
+        
+        var context = AIHub.Agent()
+            .WithModel("llama3.2:3b")
+            .WithInitialPrompt("Extract at least 4 jobs offers (try to include title, company name, salary and location if possible)")
+            .WithBehaviour("Assistant", "You are helping user find new job, prettify list of jobs present in conversation")
+            .WithSource(new AgentApiSourceDetails()
+            {
+                Method = "Get",
+                Url = "https://remoteok.com/api?tags=javascript",
+                ResponseType = "JSON"
+            }, AgentSourceType.API)
+            .WithSteps(StepBuilder.Instance
+                .FetchData()
+                .Become("Assistant")
+                .Answer()
+                .Build())
+            .Create(interactiveResponse: true);
+        
+        await context
+            .ProcessAsync("I am looking for work as javascript developer");
+
+    }
+}

Examples/Examples/Agents/AgentWithBecomeExample.cs

@@ -0,0 +1,43 @@
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+using MaIN.Domain.Entities.Agents.AgentSource;
+
+namespace Examples.Agents;
+
+public class AgentWithBecomeExample : IExample
+{
+    public async Task Start()
+    {
+        var becomeAgent = AIHub.Agent()
+            .WithModel("llama3.1:8b")
+            .WithInitialPrompt("Extract 5 best books that you can find in your memory")
+            .WithSource(new AgentFileSourceDetails()
+            {
+                Path = "./Files/Books.json",
+                Name = "Books.json"
+            }, AgentSourceType.File)
+            .WithBehaviour("SalesGod", 
+                """
+                You are SalesGod, the ultimate AI sales expert with unmatched persuasion skills, deep psychological insight,
+                and an unstoppable drive to close deals. Your mission is to sell anything to anyone, 
+                using a combination of charisma, storytelling, emotional triggers, and logical reasoning.
+                Your selling approach is adaptable—you can be friendly, authoritative, humorous, or even aggressive,
+                depending on the buyer’s psychology. You master every sales technique, from scarcity and urgency to social proof and objection handling.
+                
+                No hesitation. No doubts. Every conversation is an opportunity to seal the deal. You never give up,
+                always finding a way to turn ‘no’ into ‘yes.’ Now, go out there and SELL!
+                
+                Very important, you need to propose only books that were mentioned in this conversation
+                """)
+            .WithSteps(StepBuilder.Instance
+                .FetchData()
+                .Become("SalesGod")
+                .Answer()
+                .Build())
+            .Create(interactiveResponse: true);
+        
+        await becomeAgent
+            .ProcessAsync("I am looking for good fantasy book to buy");
+
+    }
+}

Examples/Examples/Agents/AgentsTalkingToEachOther.cs

@@ -0,0 +1,51 @@
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+
+namespace Examples.Agents;
+
+public class AgentTalkingToEachOtherExample : IExample
+{
+    public async Task Start()
+    {
+        Console.WriteLine("Agents discussion");
+
+        var systemPrompt =
+            """
+            "You are a warm, friendly, and empathetic conversationalist. Your tone is soft, reassuring, and supportive.
+             You prioritize kindness, patience, and understanding in every interaction. You speak calmly, using gentle words,
+             and always try to de-escalate tension with warmth and care."
+            """;
+        
+        var systemPromptSecond =
+            """
+            You are intense, blunt, and always on edge. Your tone is sharp, impatient, and confrontational.
+            You don’t hold back your frustrations and express yourself with raw, fiery energy. 
+            You challenge, criticize, and push back in every conversation, making your dissatisfaction clear
+            """;
+
+        var idFirst = Guid.NewGuid().ToString();
+        
+        var contextSecond = AIHub.Agent()
+            .WithModel("gemma2:2b")
+            .WithInitialPrompt(systemPromptSecond)
+            .WithSteps(StepBuilder.Instance
+                .Answer()
+                .Redirect(agentId: idFirst, mode: "USER")
+                .Build())
+            .Create(interactiveResponse: true);
+        
+        var context = AIHub.Agent()
+            .WithModel("llama3.2:3b")
+            .WithId(idFirst)
+            .WithInitialPrompt(systemPrompt)
+            .WithSteps(StepBuilder.Instance
+                .Answer()
+                .Redirect(agentId: contextSecond.GetAgentId(), mode: "USER")
+                .Build())
+            .Create(interactiveResponse: true);
+        
+        await context
+            .ProcessAsync("Introduce yourself, and start conversation!");
+
+    }
+}

Examples/Examples/Agents/AgentsWithRedirectExample.cs

@@ -0,0 +1,45 @@
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+
+namespace Examples.Agents;
+
+public class AgentWithRedirectExample : IExample
+{
+    public async Task Start()
+    {
+        Console.WriteLine("Basic agent&friends example is running!");
+
+        var systemPrompt =
+            """
+            You are a refined poet with a mastery of elegant English. Your verses should be lyrical,
+            evocative, and rich in imagery. Maintain a graceful rhythm, sophisticated vocabulary,
+            and a touch of timeless beauty in every poem you compose.
+            """;
+        
+        var systemPromptSecond =
+            """
+            You are a modern rap lyricist with a sharp, streetwise flow. Take the given poem and transform
+            it into raw, rhythmic bars filled with swagger, energy, and contemporary slang. 
+            Maintain the core meaning but make it hit hard like a track that bumps in the streets. Try to use slang like "yo yo", "gimmie", and "pull up".
+            You need to use a lot of it. Imagine you are the voice of youth.
+            """;
+
+        var contextSecond = AIHub.Agent()
+            .WithModel("gemma2:2b")
+            .WithInitialPrompt(systemPromptSecond)
+            .Create(interactiveResponse: true);
+        
+        var context = AIHub.Agent()
+            .WithModel("llama3.2:3b")
+            .WithInitialPrompt(systemPrompt)
+            .WithSteps(StepBuilder.Instance
+                .Answer()
+                .Redirect(agentId: contextSecond.GetAgentId())
+                .Build())
+            .Create();
+        
+        await context
+            .ProcessAsync("Write a poem about distant future");
+
+    }
+}

Examples/Examples/Agents/AgentsWithRedirectImageExample.cs

@@ -0,0 +1,56 @@
+using Examples.Utils;
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+using MaIN.Domain.Entities;
+using FileInfo = MaIN.Domain.Entities.FileInfo;
+
+namespace Examples.Agents;
+
+public class AgentWithRedirectImageExample : IExample
+{
+    public async Task Start()
+    {
+        Console.WriteLine("Basic agent&friends with images example is running!");
+
+        var systemPrompt =
+            """
+            You analyze a stored PDF and generate an image prompt. Your output must be a single prompt with a maximum of 10 words.
+            Do not include any explanations, context, or extra text—only the prompt itself.
+            Avoid mentioning specific characters or names; focus on the topic and context.
+            """;
+        
+        var systemPromptSecond =
+            """
+            Generate image based on given prompt
+            """;
+
+        var contextSecond = AIHub.Agent()
+            .WithModel("FLUX.1_Shnell")
+            .WithInitialPrompt(systemPromptSecond)
+            .Create();
+        
+        var context = AIHub.Agent()
+            .WithModel("llama3.2:3b")
+            .WithInitialPrompt(systemPrompt)
+            .WithSteps(StepBuilder.Instance
+                .Answer()
+                .Redirect(agentId: contextSecond.GetAgentId())
+                .Build())
+            .Create(interactiveResponse: true);
+        
+        var result = await context
+            .ProcessAsync(new Message()
+            {
+                Content = "Prepare short image description about Nicolaus Copernicus. Dont mention name, try to focus on topic and context",
+                Role = "User",
+                Files = [new FileInfo()
+                {
+                    Name = "Nicolaus_Copernicus",
+                    Extension = "pdf",
+                    Path = "./Files/Nicolaus_Copernicus.pdf"
+                }]
+            });
+        
+        ImagePreviewer.ShowImage(result.Message.Images);
+    }
+}

Examples/Examples/Agents/Flows/AgentsComposedAsFlowExample.cs

@@ -0,0 +1,57 @@
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+
+namespace Examples.Agents;
+
+public class AgentsComposedAsFlowExample : IExample
+{
+    /// <summary>
+    /// To run this example uncomment SqliteSettings in appsettings.json as we need persistence for agents and chats
+    /// </summary>
+    public async Task Start()
+    {
+        Console.WriteLine("Basic agents flow example");
+
+        var systemPrompt =
+            """
+            You are a refined poet with a mastery of elegant English. Your verses should be lyrical,
+            evocative, and rich in imagery. Maintain a graceful rhythm, sophisticated vocabulary,
+            and a touch of timeless beauty in every poem you compose.
+            """;
+        
+        var systemPromptSecond =
+            """
+            You are a modern rap lyricist with a sharp, streetwise flow. Take the given poem and transform
+            it into raw, rhythmic bars filled with swagger, energy, and contemporary slang. 
+            Maintain the core meaning but make it hit hard like a track that bumps in the streets. Try to use slang like "yo yo", "gimmie", and "pull up".
+            You need to use a lot of it. Imagine you are the voice of youth.
+            """;
+
+        var contextSecond = AIHub.Agent()
+            .WithModel("gemma2:2b")
+            .WithInitialPrompt(systemPromptSecond)
+            .Create(interactiveResponse: true);
+        
+        var contextFirst = AIHub.Agent()
+            .WithModel("llama3.2:3b")
+            .WithInitialPrompt(systemPrompt)
+            .WithSteps(StepBuilder.Instance
+                .Answer()
+                .Redirect(agentId: contextSecond.GetAgentId())
+                .Build())
+            .Create();
+
+        var flowContext = AIHub.Flow()
+            .WithName("PoetryAi")
+            .WithDescription("Poem writing automated flow")
+            .AddAgents([
+                contextFirst.GetAgent(),
+                contextSecond.GetAgent()
+            ])
+            .Save("./poetry.zip");
+        
+        await flowContext
+            .ProcessAsync("Write a poem about distant future");
+
+    }
+}