ElBruno.Hermes.Adapters 2.0.2

HermesNET — .NET 10 Distributed Agent Runtime

| Library | NuGet | Downloads | |---|---|---| | ElBruno.Hermes.Core | NuGet | Downloads | | ElBruno.Hermes.Adapters | NuGet | Downloads | | ElBruno.Hermes.Tool | NuGet | Downloads | Build Status Publish Status License: Apache-2.0

A comprehensive runtime for building intelligent agent applications with session persistence, observability, and provider abstraction built on .NET 10.

Quick Start

Get running in three steps:

1. Install the .NET tool

dotnet tool install -g ElBruno.Hermes.Tool

2. Configure your provider

hermesnet config

This creates a config file at:

• Windows: %APPDATA%\Hermes\appsettings.json
• macOS/Linux: ~/.hermes/appsettings.json

OpenAI API keys are stored in the native OS credential store and are not written to the JSON config file.

3. Run a sample prompt

hermesnet chat --profile default --message "Hello! What is 2+2?"

Note: First run creates a default profile automatically. See Quick Start Guide for more examples and workflows.

Documentation

Getting Started

• Quick Start Guide — Detailed setup and first commands
• CLI User Guide — Complete workflows and commands

Reference

• CLI Reference — Exhaustive command documentation
• Troubleshooting — Common issues and solutions

Development & Architecture

• Skill Authoring — Build custom skills
• API Reference — REST API endpoints
• User Guide — Core concepts (profiles, sessions, memory)

Release & Publishing

• Release Notes v2.0.2 — Latest features
• Publishing Guide — Release & NuGet publishing

Architecture & Testing

• Architecture Decisions — See .squad/decisions.md
• Testing & Quality — See docs/testing/ folder
• Benchmarks — See docs/benchmarks/ folder
• M1 Baseline — See M1-BASELINE.txt (telemetry baseline measurements)

Prerequisites

• .NET 10.0 or later
• Visual Studio 2025 or VS Code with C# DevKit (recommended)
• An LLM provider:
  • Local: Ollama (free, runs locally)
  • Cloud: OpenAI or compatible API

Development

Building from source

dotnet restore
dotnet build

Running tests

dotnet test

See Building & Testing Docs for detailed build instructions.

Project Overview

Core Projects

• src/Hermes.Core/ — Core runtime library (session, chat abstractions, telemetry)
• src/Hermes.Host/ — Application host (DI, provider factory, configuration)
• src/Hermes.Cli/ — Command-line interface (System.CommandLine-based)

Architecture Highlights

• Session Persistence — Built-in conversation and profile storage
• Provider Abstraction — Pluggable LLM providers (Ollama, OpenAI, custom)
• OpenTelemetry — Distributed tracing and observability from day one
• C# 13 — Modern language features with nullable safety

Contributing

• All code must build with zero warnings (TreatWarningsAsErrors=true)
• Use C# 13 features freely (latest language version)
• Maintain nullable reference type safety
• Cover critical paths with xUnit tests

License

See LICENSE file in repository root.