Change8

Migrating to Hermes Agent v2026.3.28

Version v2026.3.28 introduces 2 breaking changes. This guide details how to update your code.

Released: 3/28/2026

2
Breaking Changes
2
Migration Steps
25
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

hermes model subcommandswe-rexModal SDKSandbox.create.aioexec.aiopre_llm_callpost_llm_callon_session_starton_session_endGPT_TOOL_USE_GUIDANCElitellmuv.lockHugging Face Inference APIOpenRouterNous PortalTelegram Private Chat TopicsAlibaba providerMiniMax providerClaude APIOpenAI APIAsyncOpenAIhttpxreasoningreasoning_detailscodex_reasoning_items

Breaking Changes

Issue #1

The `/model` slash command has been removed from the CLI and gateway. Users should now use the `hermes model` subcommand instead.

Issue #2

The `swe-rex` dependency has been removed and replaced with the native Modal SDK. This may require adjustments if your workflow relied on specific `swe-rex` functionalities.

Migration Steps

  1. 1
    Replace usage of the `/model` slash command with the `hermes model` subcommand.
  2. 2
    If you were directly using the `swe-rex` dependency, migrate to the native Modal SDK (`Sandbox.create.aio` + `exec.aio`).

Release Summary

Hermes Agent v0.5.0 introduces significant hardening with new providers like Hugging Face, an overhauled /model command, Telegram Private Chat Topics, native Modal SDK, plugin lifecycle hooks, improved OpenAI tool-use enforcement, Nix flake support, and over 50 security and reliability fixes, including a comprehensive supply chain audit.

Need More Details?

View the full release notes and all changes for Hermes Agent v2026.3.28.

View Full Changelog