The agent that grows with you
Hermes v2026.3.28 adds Hugging Face inference, Telegram topic isolation, plugin lifecycle hooks, native Modal SDK, and a Nix flake.
$ git clone --branch v2026.3.28 https://github.com/NousResearch/hermes-agent.git # already have the repo? check out this version: $ git checkout v2026.3.28
- ›Adds Hugging Face Inference API as a first-class provider with auth, setup wizard, curated agentic model picker, and live
/modelsendpoint probe. - ›Enables Telegram Private Chat Topics for project-based conversations with per-topic skill binding and isolated workflows within a single chat.
- ›Activates plugin lifecycle hooks —
pre_llm_call,post_llm_call,on_session_start, andon_session_end— now firing in the agent loop and CLI/gateway. - ›Replaces swe-rex dependency with native Modal SDK (
Sandbox.create.aio+exec.aio), eliminating tunnel requirements for the Modal terminal backend. - ›Adds
GPT_TOOL_USE_GUIDANCEto enforce tool calls in GPT models instead of prose descriptions, and strips stale budget warnings from conversation history.
+15 moreshow less
- ›Introduces Nix flake with full uv2nix build, NixOS module with persistent container mode, and auto-generated config keys from Python source.
- ›Expands Nous Portal to 400+ available models via a single provider endpoint.
- ›Adds
/resumeCLI handler andreopen_sessionAPI for returning to previous sessions. - ›Adds
--sourceflag for third-party session isolation by origin. - ›Introduces session search recent-sessions mode — omit query to browse recent sessions with titles, previews, and timestamps.
- ›Exposes
compression.target_ratio,protect_last_n, andthresholdinDEFAULT_CONFIGfor ratio-based context compression tuning. - ›Persists reasoning across gateway session turns with new schema v6 columns (
reasoning,reasoning_details,codex_reasoning_items). - ›Adds supply chain hardening: CI workflow scanning PRs for supply chain attack patterns, pinned dependency ranges, and regenerated
uv.lockwith hashes. - ›Adds per-model native output limits for Anthropic models (128K for Opus 4.6, 64K for Sonnet 4.6) replacing hardcoded 16K
max_tokens. - ›Adds thinking-budget exhaustion detection to skip useless continuation retries when a model uses all output tokens on reasoning.
- ›Gives subagents independent iteration budgets.
- ›Surfaces all retry, fallback, and compression events to the user as formatted messages.
- ›Adds auto-discovery of fallback IPs via DNS-over-HTTPS when
api.telegram.orgis unreachable. - ›Removes
/modelslash command from CLI and gateway in favor ofhermes modelsubcommand. - ›Increases API timeout default from 900s to 1800s to support slow-thinking models.
- !The
/modelslash command is removed from CLI and gateway; use thehermes modelsubcommand instead. - !The
summary_target_tokensconfig key is replaced with ratio-based scaling; existing configurations referencing it will have no effect. - !The
litellmdependency is removed; any external code or plugins that relied on it will break.