HPD.Agent.Framework

            ██╗  ██╗██████╗ ██████╗       █████╗  ██████╗ ███████╗███╗   ██╗████████╗
            ██║  ██║██╔══██╗██╔══██╗     ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝
            ███████║██████╔╝██║  ██║█████╗███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   
            ██╔══██║██╔═══╝ ██║  ██║╚════╝██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   
            ██║  ██║██║     ██████╔╝      ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   
            ╚═╝  ╚═╝╚═╝     ╚═════╝       ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   

The HPD Agent Framework is a battery first agentic framework designed to enable you to create reliable agents as quickly as possible. We build the infrastructure for reliable autonomous agents, you build the future.

📚 Full Documentation | Getting Started | Examples

The single philosophy driving this library: "Make Simple Things Simple, Make Complex Things Possible"

Main Characteristics

• Lightweight
• Native AOT First
• Builder and Configuration First
• Provider Agnostic
• Event Streaming First

Built-In Features

• Custom Event Protocol - Easily receive a serialzed protool of all events emitted by the agent
• Middleware - Extensible middleware system for customizing agent behavior
• Durable Execution - Checkpointing and conversation thread persistence
• PII Filtering - Remove sensitive information before it reaches the LLM
• Error Handling - Built in Provider Error Handling
• Permissions - Permission system for tool execution control
• History Reduction - Conversation summarization and context window management
• Tool Calling - First-class support for function/tool calling with automatic schema generation
• Tool Collapsing - Innovative mechanism to reduce tool context(without RAG or Code Execution or Truncation)
• Skills - Provider agnostic way to define reusable agent skills
• Observability - Built-in event system for logging, telemetry, and debugging
• Planning - Built-in plan mode for complex tasks
• SubAgents - Built-in support for nested agent orchestration
• MCP Support - Supports MCP with Collapsing/Collapsing Mechanism
• Audio Support - Built-in support for native and tts -> llm -> tts providers
• Local Sandbox Execution - Execute code tools in a secure local sandbox environment

[!WARNING] HPD.Agent.Framework is currently in an early development phase.

Until the release of version 1.0, the API, inner mechanisms and naming are subject to significant changes without notice.

Quick Start

using HPD.Agent;
using HPD.Agent.Providers.OpenAI;

var agent = await new AgentBuilder()
    .WithProvider("openai", "gpt-4o")
    .WithName("Assistant")
    .WithInstructions("You are a helpful assistant.")
    .WithEventHandler(new ConsoleEventHandler())
    .Build();

await foreach (var _ in agent.RunAsync("Hello!")) { }

Advanced Example

using HPD.Agent;
using HPD.Agent.Providers.OpenAI;

var agent = await new AgentBuilder()
    .WithProvider("openai", "gpt-4o")
    .WithName("ResearchAssistant")
    .WithInstructions("You are a research assistant with access to tools and knowledge.")
    // Toolkits & Tools
     .WithTool<WebSearchToolkit>()
     .WithTool<FileSystemToolkit>()
    .WithToolCollapsing()                              // Reduces tool context for better performance
    // Middleware
    .WithPermissions()                              // Require approval for sensitive operations
    .WithPIIProtection()                            // Filter sensitive data
    .WithHistoryReduction(config => {
        config.Strategy = HistoryReductionStrategy.Summarizing;
        config.TargetMessageCount = 30;
    })
    .WithCircuitBreaker(maxConsecutiveCalls: 5)
    .WithFunctionRetry()
    // Memory
    .WithStaticMemory(opts => {
        opts.StorageDirectory = "./knowledge";
        opts.AddDocument("./docs/company-policies.md");
    })
    .WithDynamicMemory(opts => {
        opts.StorageDirectory = "./memory";
        opts.EnableAutoEviction = true;
    })
    .WithPlanMode()                                 // Enable planning capabilities
    // Observability
    .WithLogging(loggerFactory)
    .WithTelemetry()
    .WithEventHandler(new ConsoleEventHandler())

    .Build();

await foreach (var evt in agent.RunAsync("Research the latest AI trends"))
{
    // Process streaming events
}

Requirements

• .NET 8.0, 9.0, or 10.0
• Microsoft.Extensions.AI 9.0.0+

License

Proprietary - See LICENSE file.