Hermes Agent — Enterprise Autonomous AI Platform

Deploy Nous Research's Hermes Agent in enterprise environments with sovereign infrastructure, EU AI Act compliance, and deep ERP/government/trade integrations.

Built for PST.AG — Berlin's market leader in global trade solutions and ERP integration.

Job Title: Senior AI Engineer – Hermes Agent
Mission: Architect and deploy autonomous, self-improving "digital colleagues" within complex corporate environments.

---

Architecture

                           ┌──────────────────┐
                           │  Hermes Agent    │
                           │  (Nous Research) │
                           │  v0.17.0         │
                           └────────┬─────────┘
                                    │
              ┌─────────────────────┼─────────────────────┐
              │                     │                     │
       ┌──────┴──────┐      ┌──────┴──────┐      ┌──────┴──────┐
       │   ERP MCP   │      │ Government  │      │   Trade     │
       │   Server    │      │ MCP Server  │      │ MCP Server  │
       │ (SAP/Odoo)  │      │ (ELSTER/    │      │ (Customs/   │
       │             │      │  BundesAPI) │      │  Logistics) │
       └──────┬──────┘      └──────┬──────┘      └──────┬──────┘
              │                     │                     │
              v                     v                     v
       ┌──────────┐        ┌──────────────┐      ┌──────────────┐
       │   ERP    │        │ Government   │      │   Global     │
       │ Systems  │        │ Portals      │      │ Trade Nets   │
       └──────────┘        └──────────────┘      └──────────────┘

Core Components

Layer	Technology	Purpose
Agent Runtime	Hermes Agent (Nous Research)	Autonomous agent with persistent memory, skill creation, multi-platform gateway
Enterprise Profile	SOUL.md + config.yaml	PST.AG-specific persona, model config, security boundaries, compliance settings
ERP Integration	MCP Server (SAP/Odoo)	Material management, sales orders, invoicing, inventory via RFC/REST/XML-RPC
Government Integration	MCP Server (ELSTER/BundesAPI)	Tax filings, compliance status, regulatory calendar, business registration
Trade Integration	MCP Server (Customs/Logistics)	Customs declarations, shipment tracking, HS code tariffs, letters of credit
Self-Evolution	GEPA + DSPy	Offline skill optimization from execution traces
Memory	HindSight + Qdrant	Persistent session-spanning memory with vector search
Infrastructure	Docker / Kubernetes / Terraform	Self-hosted sovereign deployment on EU-only infrastructure
Compliance	EU AI Act / GDPR	Risk assessment, audit trails, human oversight, DPIA

---

Quick Start

Prerequisites

• Hermes Agent installed (Windows / Linux/macOS)
• OpenRouter API key (or self-hosted vLLM/Ollama)
• Python 3.11+

1. Install Hermes Agent

# Linux/macOS
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

2. Configure Enterprise Profile

# Copy PST.AG profile to Hermes home
cp -r profiles/pst-ag ~/.hermes/profiles/

# Activate the profile
hermes profile activate pst-ag

# Run setup (uses OpenRouter free tier)
hermes setup

3. Run Live Interactive Demo (Out of the Box)

To demonstrate the full integration pipeline (SAP Material Search -> Trade Compliance check -> Logistics estimation -> JSON State Checkpointing -> Agentic evaluation scores) without needing real API keys:

python demo_run.py

4. Start MCP Servers (in separate terminals)

# ERP Gateway (SAP/Odoo)
cd mcp-servers/erp-gateway && pip install -r requirements.txt && python server.py

# Government Portal (ELSTER/BundesAPI)
cd mcp-servers/government-portal && pip install -r requirements.txt && python server.py

# Trade Solutions (Customs/Logistics)
cd mcp-servers/trade-solutions && pip install -r requirements.txt && python server.py

5. Start Interactive Chat Shell (Recommended)

You can chat with the Orchestrator Agent directly in your terminal using:

python chat.py

This starts an interactive prompt session where you can type queries (e.g. Research EU AI Act compliance deadlines). If you configure your OpenRouter key in the .env file, the agent will query real models. Otherwise, it runs in Mock mode.

6. Use the Agent

# Start interactive chat with PST.AG personality
hermes --profile pst-ag

# One-shot query
hermes -z "Check inventory levels for material R-2020-001 in SAP"

# Research a compliance topic
hermes -z "What are our upcoming EU AI Act compliance deadlines?"

---

Enterprise Skills

Skill	Description	Category
erp-integration	SAP/Odoo material management, orders, inventory	Enterprise
compliance-reporting	EU AI Act, GDPR, regulatory filings	Compliance
trade-logistics	Customs, shipping, Incoterms, HS codes	Trade

Skills follow the agentskills.io open standard and install with:

hermes skills install ./skills/erp-integration

---

MCP Servers

Server	Tools	Integration
ERP Gateway	erp_search_materials, erp_get_sales_order, erp_list_invoices, erp_create_customer, erp_get_inventory_level, erp_list_open_orders	SAP S/4HANA (RFC/REST), Odoo (XML-RPC)
Government Portal	gov_submit_tax_declaration, gov_check_compliance_status, gov_get_regulatory_calendar, gov_submit_compliance_report, gov_verify_business_registration, gov_get_tax_certificate	ELSTER, BundesAPI, EU e-Government
Trade Solutions	trade_create_customs_declaration, trade_track_shipment, trade_get_tariff_info, trade_generate_letter_of_credit, trade_validate_export_compliance, trade_get_exchange_rates, trade_estimate_delivery, trade_get_carrier_options	Customs, Logistics, Trade Finance

Each server includes mock adapters for development — no real credentials required to test.

---

Self-Evolution (GEPA)

The GEPA (Genetic-Pareto Prompt Evolution) pipeline optimizes skills and prompts from execution traces:

# Run evolution for ERP integration skill
cd self-evolution
./run-evolution.sh --skill erp-integration --eval-source hindsight

See self-evolution/gepa-config.yaml for optimizer configuration.

---

Compliance

EU AI Act

The framework covers all requirements for high-risk AI systems (Articles 8-15):

• ✅ Risk management system (Art. 9)
• ✅ Training data governance (Art. 10)
• ✅ Technical documentation (Art. 11)
• ✅ Record keeping / logging (Art. 12)
• ✅ Transparency / explainability (Art. 13)
• ✅ Human oversight (Art. 14)
• ✅ Accuracy, robustness, cybersecurity (Art. 15)

See compliance/eu-ai-act/compliance-framework.md for complete documentation.

---

Deployment

Docker Compose (Development)

docker-compose up -d

Kubernetes (Production)

kubectl apply -f infrastructure/kubernetes/

Terraform (Sovereign Cloud)

cd infrastructure/terraform
terraform init
terraform apply -var="region=eu-central-1"

---

Project Structure

├── profiles/pst-ag/          # Enterprise profile: SOUL.md, config, skills
├── mcp-servers/
│   ├── erp-gateway/          # SAP/Odoo ERP integration
│   ├── government-portal/    # ELSTER/BundesAPI integration
│   └── trade-solutions/      # Customs/logistics/trade finance
├── skills/                   # agentskills.io enterprise skills
│   ├── erp-integration/
│   ├── compliance-reporting/
│   └── trade-logistics/
├── self-evolution/           # GEPA optimization pipeline
│   ├── gepa-config.yaml
│   ├── eval-datasets/
│   └── evolved-skills/
├── infrastructure/           # Deployment infrastructure
│   ├── docker/
│   ├── kubernetes/
│   └── terraform/
├── compliance/               # EU AI Act + GDPR framework
│   ├── eu-ai-act/
│   └── gdpr/
├── src/hermes/               # Legacy Python platform (reference)
├── docs/
├── docker-compose.yml
└── Dockerfile

---

Technology Stack

Category	Technology
Agent Runtime	Hermes Agent (Nous Research)
LLM Providers	OpenRouter, vLLM (self-hosted), Ollama
Memory	HindSight (local/cloud), Qdrant (vector), Redis (cache)
Agent Protocol	MCP (Model Context Protocol) — 3 custom servers
Skills Standard	agentskills.io open standard
Self-Evolution	GEPA + DSPy (ICLR 2026 Oral)
Compliance	EU AI Act, GDPR
Infrastructure	Docker, Kubernetes, Terraform (AWS EU)
Messaging	Telegram, Slack, Discord, WhatsApp, Email

---

License

MIT. See LICENSE.

Built by mysterious75