FabrCore.Sdk 0.7.7

FabrCore

👁 NuGet
👁 .NET 10
👁 Orleans 10

A .NET framework for building distributed AI agent systems on Orleans and Microsoft Agent Framework.

FabrCore provides the building blocks for creating, hosting, and connecting to AI agents that run as Orleans grains. Agents are durable, scalable, and communicate through a structured message-passing architecture with built-in support for LLM providers, tool execution, MCP integration, and real-time monitoring.

Website: fabrcore.ai | Built by: Vulcan365 AI

New to FabrCore? Start with the blogs and guides on fabrcore.ai/blogs for walkthroughs, architecture deep-dives, and real-world patterns.

Key Features

• Distributed AI Agents -- Orleans grains with durable state, timers, reminders, and health monitoring
• Microsoft Agent Framework -- Built on Microsoft.Agents.AI with ChatClientAgent, sessions, and thread patterns
• Multi-LLM Support -- Azure OpenAI, OpenAI, Anthropic, and custom providers via Microsoft.Extensions.AI
• Plugins and Tools -- Stateful plugins and stateless standalone tools with dependency injection
• MCP Integration -- Model Context Protocol servers via Stdio and HTTP transports
• Inter-Agent Messaging -- Fan-out, pipeline, supervisor patterns with ACL-based access control
• Real-Time Monitoring -- Agent message traffic, events, LLM request/response capture, and token tracking
• ChatDock UI -- Floating chat panel component for Blazor Server with multi-instance support
• Audio Transcription -- Azure OpenAI gpt-4o transcription model support
• Testing Harness -- In-memory agent testing with mock and live LLM modes

Architecture

+---------------------------------------------------+
| Your Application |
+-------------------+-------------------------------+
| FabrCore.Client | FabrCore.Host |
| ClientContext | AgentGrain (Orleans 10) |
| ChatDock (UI) | API / Chat Completions |
| Health Monitor | WebSocket Middleware |
+-------------------+-------------------------------+
| FabrCore.Sdk |
| FabrCoreAgentProxy * ChatClientAgent |
| Plugins * Tools * MCP * Agent Monitor |
+---------------------------------------------------+
| FabrCore.Core |
| Interfaces * Data Models * Grain Abstractions |
+---------------------------------------------------+

Packages

Quick Start

1. Install packages

dotnet add package FabrCore.Host

FabrCore.Host pulls in FabrCore.Sdk and FabrCore.Core transitively. For client applications, add FabrCore.Client instead.

2. Create an agent

using FabrCore.Sdk;
using FabrCore.Core;

[AgentAlias("my-assistant")]
public class MyAssistantAgent : FabrCoreAgentProxy
{
 public override async Task<AgentMessage> OnMessage(AgentMessage message)
 {
 var (agent, session) = await Host.CreateChatClientAgent(
 modelName: "AzureProd",
 instructions: "You are a helpful assistant."
 );

 var response = await agent.SendAsync(session, message.Text);
 return message.ToReply(response);
 }
}

3. Configure the server

var builder = WebApplication.CreateBuilder(args);

builder.AddFabrCoreServer();

var app = builder.Build();
app.UseFabrCoreServer();
app.Run();

4. Configure model access

Copy FabrCore.json.example to FabrCore.json in your project root and add your LLM provider configuration:

{
 "ModelConfigurations": [
 {
 "Name": "AzureProd",
 "Provider": "Azure",
 "Uri": "https://your-resource.cognitiveservices.azure.com/",
 "Model": "gpt-4.1-mini",
 "ApiKeyAlias": "AZURE_KEY"
 }
 ],
 "ApiKeys": [
 {
 "Alias": "AZURE_KEY",
 "Value": "your-api-key-here"
 }
 ]
}

Note: FabrCore.json is gitignored by default to prevent accidental secret commits.

Documentation

Full documentation is available in the directory:

Check out the FabrCore Blog for tutorials, architecture deep-dives, integration guides, and best practices.

Technology Stack

• .NET 10 -- Latest .NET runtime
• Orleans 10.0 -- Distributed actor framework for grain-based agents
• Microsoft.Agents.AI 1.0 -- Microsoft Agent Framework for AI agent patterns
• Microsoft.Extensions.AI -- Unified AI abstractions for multi-provider LLM support
• Blazor Server -- Real-time web UI for agent interaction

Building from Source

dotnet build src/FabrCore.sln

License

Licensed under the .

See for attribution requirements.

Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

Links

• FabrCore Website
• FabrCore Blog
• Vulcan365 AI
• NuGet Packages
• Orleans Documentation
• Microsoft Agent Framework