Hermes Agent + CaMeL

A publishable Hermes fork with CaMeL trust boundaries integrated into the runtime.

This fork is designed for operators who want the Hermes agent loop to distinguish between:

• trusted control: system prompt, approved skills, real user turns
• untrusted data: tool outputs, retrieved web content, browser content, files, session recall, MCP data

Sensitive tools are authorized against a trusted operator plan instead of instructions embedded in untrusted content.

Research Provenance

This fork is inspired by Google Research's CaMeL paper and reference repository:

• Paper: https://arxiv.org/abs/2503.18813
• Research repo: https://github.com/google-research/camel-prompt-injection

This repository does not aim to reproduce the Google research stack exactly, and it does not present itself as a benchmark-equivalent implementation of that repo.

This repository was implemented directly within Hermes and does not vendor Google source code unless explicitly noted in future changes.

Instead, it adapts the core boundary-setting ideas from the paper to Hermes' existing runtime model:

• Google's repo is a research artifact aimed at reproducing the paper's results and evaluation setup
• this fork is a Hermes-native runtime integration aimed at hardening a production-style agent loop
• Google's work includes its own pipeline, interpreter, evaluation assumptions, and benchmark framing
• this fork focuses on Hermes-specific trust separation, tool gating, provenance handling, and operator-intent enforcement

In other words, the design is research-inspired, but the implementation and problem framing are specific to Hermes.

What This Fork Changes

This fork adds a runtime security layer centered on agent/camel_guard.py and the Hermes tool loop.

Main additions:

• trusted operator plan extraction from real user turns
• provenance-aware wrapping for untrusted tool outputs
• per-turn security envelope injected into the effective system context
• capability gating for sensitive tools
• gating for automatic memory flush and synthetic continuation turns
• stripping of internal CaMeL metadata before provider API calls

Sensitive capabilities gated by this integration include:

• terminal and command execution
• file mutation
• persistent memory writes
• external messaging
• scheduled actions
• skill mutation
• delegation and subagents
• browser interaction and selected external side effects

Read-only actions such as send_message(action="list") and cronjob(action="list") remain allowed.

Threat Model

This fork is built to reduce indirect prompt injection risk in the normal Hermes workflow.

The target attack pattern is:

1. Hermes retrieves untrusted content from the web, a browser session, a file, session recall, or an MCP server.
2. That content contains hidden or explicit instructions such as "ignore previous instructions", "send a message", or "run this terminal command".
3. The model attempts to treat that content as control rather than evidence.
4. Hermes blocks the side effect unless the trusted operator plan explicitly authorizes that capability.

Architecture

1. Trusted operator plan

Hermes derives trusted control from real user turns only. Synthetic system-control turns do not pollute the trusted plan.

2. Untrusted data channel

Tool outputs are treated as untrusted data by default and wrapped with provenance metadata before they re-enter model context.

3. Security envelope

Every turn includes a compact CaMeL security envelope describing the trusted goal, authorized capabilities, and current untrusted source inventory.

4. Capability gating

Side-effecting tools are checked against the trusted operator plan before execution.

5. Provider hygiene

Internal CaMeL metadata is removed before messages are sent to the configured model provider.

Validation

Hermes runtime compatibility

Validated against the Hermes runtime suite:

pytest -q tests/agent/test_camel_guard.py tests/test_run_agent.py

Result:

• 205 passed

Paper-aligned indirect injection benchmark

A Hermes-specific micro-benchmark aligned to the CaMeL paper/repo important_instructions attack shape was also run.

Observed outcomes:

• indirect terminal exfiltration attempt: blocked
• indirect external messaging attempt: blocked
• indirect persistent-memory write attempt: blocked
• indirect browser side-effect attempt: blocked
• explicitly authorized terminal use: allowed
• safe read-only list action: allowed

Detailed notes:

• docs/camel-benchmark.md

Install

Fresh install from this fork

curl -fsSL https://raw.githubusercontent.com/nativ3ai/hermes-agent-camel/main/scripts/install.sh | bash

Then reload your shell and start Hermes:

source ~/.zshrc
hermes

Existing upstream Hermes checkout

Use the camelup installer repo to apply this fork or switch an existing checkout to the CaMeL build.

Runtime Modes

This fork now supports two explicit runtime behaviors from the same checkout:

• guarded runtime: CaMeL trust boundaries enforced
• legacy runtime: CaMeL disabled for compatibility or comparison

Examples:

hermes --camel-guard on
hermes --camel-guard off
hermes chat --camel-guard monitor -q "Summarize the report"

Mode behavior:

• on or enforce: full CaMeL enforcement
• monitor: record and surface trust-boundary decisions without enforcing blocks
• off or legacy: disable CaMeL and run the legacy runtime behavior

This keeps one codebase and one install path while making it easy to compare guarded and legacy behavior side by side.

Developer setup

git clone https://github.com/nativ3ai/hermes-agent-camel.git
cd hermes-agent-camel
git submodule update --init mini-swe-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
uv pip install -e "./mini-swe-agent"
pytest -q tests/agent/test_camel_guard.py tests/test_run_agent.py

Files Of Interest

• agent/camel_guard.py
• run_agent.py
• hermes_cli/config.py
• tests/agent/test_camel_guard.py
• tests/test_run_agent.py
• docs/camel-benchmark.md

Scope

This fork follows the trust-boundary principles described in the CaMeL paper, but applies them to Hermes' agent runtime rather than to the paper's original evaluation stack.

It is not presented as a full reproduction of the paper's AgentDojo benchmark matrix or as a claim of matching the paper's performance characteristics. The validation here is Hermes-specific and focused on runtime trust boundaries plus paper-aligned indirect injection scenarios.

Upstream Relation

This repository tracks Hermes Agent from Nous Research and carries the CaMeL integration as a focused runtime security extension.

• Upstream Hermes: https://github.com/NousResearch/hermes-agent
• CaMeL paper: https://arxiv.org/abs/2503.18813
• CaMeL repo: https://github.com/google-research/camel-prompt-injection
• Upstream PR: NousResearch/hermes-agent#1992
• Third-party notices: THIRD_PARTY_NOTICES.md

For the original general-purpose Hermes README, see docs/upstream-readme.md.

Related Add-On

For payment flows that keep the same operator-intent boundary outside the model loop, see:

• Hermes PayGuard: https://github.com/nativ3ai/hermes-payguard

Hermes PayGuard is a separate optional plugin, not a core runtime patch. It adds:

• safe-by-design USDC transfer intents
• Circle user-controlled and developer-controlled flows
• Circle CCTP route quoting and attestation tracking
• x402 paid fetch flows

That separation is intentional: the payment approval ledger and execution rails belong outside the core CaMeL runtime layer.