hermes-internals

Hermes Agent — Internals & Surfaces

Hermes is a self-improving, terminal-native agent: persistent memory, agent-created skills, a 20+ platform messaging gateway, runnable on local/Docker/SSH/Daytona/ Modal/Singularity backends, against Nous Portal / OpenRouter / OpenAI / Anthropic / any OpenAI-compatible endpoint. MIT licensed. Repo: github.com/NousResearch/hermes-agent. Docs: hermes-agent.nousresearch.com/docs.

A machine-readable doc index lives at /docs/llms.txt; the full concatenated docs at /docs/llms-full.txt.

The four surfaces (and when to use each)

Hermes is one engine you can reach four ways. Choosing the right one is the single biggest lever on speed when testing or automating.

Speed rule of thumb: anything that runs more than one prompt should use the library (in-process + parallel) or the API server, never a loop of hermes chat.

AIAgent — the knobs that matter

from run_agent import AIAgent

agent = AIAgent(
    model="anthropic/claude-sonnet-4.6",
    quiet_mode=True,          # suppress CLI spinners — REQUIRED when embedding
    skip_memory=True,         # don't read/write MEMORY.md — stateless & faster
    skip_context_files=True,  # don't inject AGENTS.md/.hermes.md
    max_iterations=6,         # cap tool-calling loops (default 90 is generous)
    enabled_toolsets=["web"], # or disabled_toolsets=[...]
)
text = agent.chat("…")                     # -> final string
result = agent.run_conversation("…")       # -> {"final_response", "messages"}