Hermes Agent v0.22.0 adds a free setup model, app connectors and one-click local models

What is in Hermes Agent v0.22.0?

Nous Research published Hermes Agent v0.22.0 on GitHub at 03:21 UTC on 14 October 2026. The notes give a release date of 13 October and a name, the Threshold Release, after the Greek god of doorways. The theme is getting new users through the door: a desktop install that sets itself up, connectors into apps people already use, and local models that run with no account at all.

It is a large release by any measure. Nous counts about 24,200 commits, 6,080 merged pull requests and 7,180 closed issues since v0.21.0, from roughly 2,520 contributors, and says the window was about two and a half times longer than the previous cycle. It also rolls up and documents the v0.21.1 to v0.21.7 patch releases that shipped in between.

Hermes Agent is Nous Research’s open-source personal agent. The repository describes it as a self-improving agent that writes skills from experience, keeps memory across sessions and can be reached from a terminal or from Telegram, Discord, Slack, WhatsApp and Signal. It works with many model providers and is released under the MIT License. When AI Lookout checked the repository on 14 October it showed about 254,000 GitHub stars.

How does the new first-run setup work?

Open the desktop app on a computer that has never run Hermes and it now starts a short setup chat instead of a settings screen. One card at a time, it asks for your name, an accent colour and a layout, which apps to connect and which plugins to install. It then gives a quick tour and offers up to four first tasks picked for you. Skip setup ends it, and Settings has an option to run onboarding again.

The trick that makes this work without a key is a free trial model called nous/welcome. The notes say a first desktop install with no provider or Nous account gets it once per OS user. The limit matters: the CLI, TUI and messaging gateway get no account and no free model, and existing installs or remote backends do not see the new flow automatically. When the free rate limit is hit, the turn ends with the reset time shown, and free-tier users are shown a terms and privacy notice.

The agent also gained a set_theme tool, so a request such as ‘make it violet, dark mode’ restyles the desktop app from any chat. A new Simple mode turns the desktop into a plain chat window for people who do not want the full interface, and error messages now say what went wrong with a one-click fix.

What do connectors and one-click local models change?

Connectors let Hermes act inside hosted apps. The notes name Linear and Notion as examples, reached through the Nous tool gateway: you ask for an app, sign in once in the browser, and the tools are usable in the same turn. No Nous account is needed to start, because Hermes creates a free connectors-only identity the first time you use an app. A new Connectors page lists hosted apps and your own MCP servers together and replaces the old MCP tab, and you can keep several named accounts for one app, such as work and home.

Local models are now one click. Hermes installs and maintains llama.cpp with the right engine for the machine, whether CPU, CUDA, Metal, Vulkan or ROCm, rates each catalog model against your GPU and RAM, and picks the highest-quality build that fits. Downloads pause and resume, and the local server starts and stops with Hermes. The catalog lists Qwen3.8 27B, Qwen3.8 Flash Next, Qwen3.6 35B-A3B and DeepSeek V4 Flash, plus any GGUF file from Hugging Face. It is the same packaging problem Hugging Face tackled with its Llama Windows tray app, now built into an agent.

Both features pull in the same direction, but they are different trust choices. Local models keep prompts on your hardware. Connectors route actions in your work apps through a Nous-hosted gateway. People who chose Hermes for self-hosting should check which path a given task uses; the notes say connectors can be turned off with a single configuration setting and guest identities with another.

What else changed for people already running Hermes?

Installs now follow tested SemVer releases by default rather than every commit on main. Nous says each release passes source CI, Docker, Nix, signed desktop builds and install and upgrade runs on every OS before publication. The desktop app is a signed package that carries its own Python and Node: a signed MSIX for x64 and ARM64 on Windows, including through the Microsoft Store, and a signed, notarised Apple Silicon build on macOS. A new package manager, hermes pm, builds each update in a fresh environment and switches only when it passes a check, so a killed update should no longer leave an install half-applied.

The plugin catalog launched this cycle and reached 600 entries, each pinned to a reviewed commit. Memory providers such as Honcho, Mem0 and Hindsight moved into it, along with Home Assistant, Spotify and Langfuse, and existing users are migrated automatically. Plugins are also the extension story in other open agents; compare the plugin API in OpenCode 2.0.

There is a lot more in the notes. The browser agent can sign in with logins from 1Password, Bitwarden or Hermes’s own encrypted vault, and Nous says the model never sees the password. Bot Screen streams the desktop of a bot running on a Linux gateway, so you can take over at a login, a 2FA prompt or a CAPTCHA and hand control back. One gateway and one desktop backend now serve every profile on a machine. Running subagents stay visible with Steer and Stop controls, and the interface ships with full coverage in 16 languages.

The codebase also shrank. Nous says source went from about 1.06 million to 698,000 lines, a 34% cut it describes as having no behaviour change, and that around 19 rarely used tools now load only when the agent searches for them, roughly halving the tool schema the desktop sends on every call.

What should you check before upgrading?

Several changes can break an existing setup. Managed installs now run on Python 3.14, and KittenTTS is not available on that version. The Windows desktop is MSIX-only and needs Windows 11 22H2 or newer, because the NSIS and MSI installers are gone. Default macOS builds are Apple Silicon only. Users who run one gateway per profile will find hermes update folding them into a single shared gateway when nothing conflicts.

Session handling changed too. Chats no longer reset on an idle or daily timer, and automatic pruning is now on by default: ended sessions inactive for 90 days are deleted at startup. Pinned and open sessions are not touched, and setting sessions.auto_prune to false keeps everything. Anyone who relies on old transcripts should change that setting before upgrading.

Plugin authors lose the old compatibility import layer, the Skill Sync command and the bundled tirith scanner, and several tools were renamed, although the notes say the old names still work. The release also lists security fixes, including dashboard sign-in hardening, secrets kept out of child processes and command lines, stronger redaction, owner-only file permissions and approvals for cloud-metadata fetches and pipe-to-shell commands. These are Nous’s descriptions; no independent audit is cited.

Why this release matters for open-source agents

Most open-source agents still ask new users to bring an API key and edit a configuration file before anything happens. v0.22.0 attacks that first step from two sides: a hosted free model for the setup chat, and a local runtime for people who never want a key at all. It also fits the business plan behind Hermes. AI Lookout reported that Nous raised $90 million to build Hermes for businesses, and an account upgrade path from the free connectors identity points the same way.

The release is also a reminder that a personal agent now touches passwords, work apps and a computer screen. Password-manager sign-in, Bot Screen and the new approval rules show Nous designing for that, but the safety of any setup still depends on which connectors, plugins and sandbox backends a user enables. The practical test is simple: install it on a spare profile, run the setup chat, and see which steps reach a hosted service before you connect real accounts.