Agentic.NET 0.3.0-preview

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of Agentic.NET. 
dotnet add package Agentic.NET --version 0.3.0-preview
                    


                    

                
NuGet\Install-Package Agentic.NET -Version 0.3.0-preview
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Agentic.NET" Version="0.3.0-preview" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Agentic.NET" Version="0.3.0-preview" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Agentic.NET" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Agentic.NET --version 0.3.0-preview
                    


                    

                
#r "nuget: Agentic.NET, 0.3.0-preview"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Agentic.NET@0.3.0-preview
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Agentic.NET&version=0.3.0-preview&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Agentic.NET&version=0.3.0-preview&prerelease
                    


                            Install as a Cake Tool

Agentic.NET NuGet Package

Build production-ready AI agents in .NET — CLI coding assistants, web chat bots, or autonomous agents like an OpenClaw-style computer-use agent. Agentic.NET handles the agent runtime (memory, tool calling, streaming, middleware, identity) so you can focus on your UI and app integrations.

This README is kept short for NuGet users; full documentation and samples are available in the GitHub repository.

Install

dotnet add package Agentic.NET

Quick example

Agentic.NET is built on Microsoft.Extensions.AI (MEAI). You need a MEAI-compatible provider package alongside this one:

dotnet add package Microsoft.Extensions.AI.OpenAI

using Agentic.Builder;
using Microsoft.Extensions.AI;
using OpenAI;

var apiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY")
    ?? throw new InvalidOperationException("Set OPENAI_API_KEY first.");

var chatClient = new OpenAIClient(apiKey).AsChatClient("gpt-4o-mini");

var agent = new AgentBuilder()
    .WithChatClient(chatClient)
    .Build();

var reply = await agent.ReplyAsync("What's up?");
Console.WriteLine(reply);

// optional: add memory, middleware and tools the same way

Key Features

  • Provider-agnostic: Works with any IChatClient from Microsoft.Extensions.AI (OpenAI, Azure, Ollama, custom)
  • Streaming: Receive tokens incrementally via StreamAsync with IAsyncEnumerable<StreamingToken>
  • Memory: SQLite, in-memory, or implement IMemoryService for custom storage
  • Semantic memory: Bring any IEmbeddingGenerator<string, Embedding<float>> for vector-based recall
  • Middleware: Pre/post-process conversation with IAssistantMiddleware
  • Tools: Register executable functions the model can invoke
  • Skills: Load capabilities from Agent Skills format
  • Identity: Define agent personality with SOUL.md format

Note: this package is a preview release; expect breaking changes until a stable version is published.

For full documentation, examples and contribution instructions see https://github.com/oorosh/agentic.net.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.3.0-preview 99 3/15/2026
0.2.1-preview 75 3/6/2026

v0.2.0-preview: Microsoft.Extensions.AI Adoption

Breaking Changes:
- Full adoption of Microsoft.Extensions.AI (MEAI) 10.3.0
- IModelProvider removed; use AgentBuilder.WithChatClient(IChatClient) instead
- IEmbeddingProvider removed; use AgentBuilder.WithEmbeddingGenerator(IEmbeddingGenerator) instead
- WithOpenAi(), WithModelProvider(), WithEmbeddingProvider(), WithOpenAiEmbeddings(), WithSemanticMemory() removed from AgentBuilder
- IMemoryService and IVectorStore now use ReadOnlyMemory<float> instead of float[] for embeddings
- Built-in OpenAI provider (Providers/OpenAi/) removed; install Microsoft.Extensions.AI.OpenAI and pass IChatClient directly

Improvements:
- Core library is now zero-provider: accepts any IChatClient and IEmbeddingGenerator
- MEAI middleware pipeline fully composable around IChatClient (logging, caching, OTel, retry)
- IAssistantMiddleware still works for turn-level middleware (memory injection, filtering, audit)