# Install hermes-agent with Homebrew, winget, apk, dnf Self-improving AI agent that creates skills from experience. Version 2026.7.20 via Homebrew; verified 2026-07-20. Also installable with winget: winget install --id fathah.HermesDesktop -e. ## Install ```sh sudo av install brew:hermes-agent ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hermes-agent ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add hermes ``` Evidence: Alpine Linux edge package indexes: hermes from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - dnf (92%): ```sh sudo dnf install Hermes ``` Evidence: Fedora Rawhide package metadata: Hermes from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst ### Windows - winget (92%): ```sh winget install --id fathah.HermesDesktop -e ``` Evidence: Windows Package Manager source index: fathah.HermesDesktop from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:hermes-agent - **Package manager:** Homebrew - **Version:** 2026.7.20 - **Source summary:** Self-improving AI agent that creates skills from experience - **Homepage:** - **Repository:** - **Last updated:** 2026-07-20T22:21:25Z - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - hermes (alias) - hermes-acp (alias) - hermes-agent (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 2026.7.20 ## Project history and usage Hermes Agent is Nous Research's open-source AI agent runtime, distributed as a CLI and companion desktop/messaging workflow. Its distinctive historical theme is not just tool use, but agent memory and self-improving skills stored across sessions. ### Project history The GitHub repository was created on July 22, 2025. The README describes Hermes as a self-improving AI agent with a built-in learning loop that creates skills from experience, improves them during use, searches past conversations, and builds cross-session user context. By 2026, the documentation and README described a broad runtime rather than a narrow terminal chatbot: a full TUI, model-provider switching, messaging gateways, scheduled automations, subagents, terminal backends, memory, MCP integrations, and research-oriented trajectory generation. ### Adoption history Hermes Agent sits in the post-2024 generation of coding and task agents where the package is expected to install not only an executable, but also a managed runtime, provider configuration, skills, memory, and optional gateways. Its installer documentation says it handles Python, Node.js, ripgrep, ffmpeg, repository checkout, virtual environment, and global command setup. The project's packaging story includes multiple command names in Homebrew and a managed install layout under `~/.hermes`, which reflects the way agent CLIs blurred the line between a local package and a persistent personal runtime. ### How it is used A user typically starts with `hermes`, chooses or configures a model provider, and then works through a terminal UI or messaging gateway. The README documents provider flexibility through Nous Portal, OpenRouter, OpenAI, user endpoints, and other backends. Skills are central to day-to-day use. Official docs describe user and agent-created skills under `~/.hermes/skills/`, a bundled skills catalog, hub-installed skills, and a write-approval gate for users who want review before background self-improvement writes skill changes. ### Why package nerds care Hermes Agent is package-nerd interesting because it makes a local CLI behave like an extensible operating environment: it owns configuration, skills, memory, provider keys, optional messaging integrations, and tool execution backends. Installing the package is therefore closer to bootstrapping a development workstation than installing a single-purpose Unix command. It also shows how AI-agent distributions began to depend on language-package managers and runtime bootstrapping. The installer leans on Python and Node ecosystems while exposing a single `hermes` command, making the package a wrapper around a larger managed environment. ### Timeline - 2025-07-22: Public GitHub repository creation date recorded by GitHub. - 2026: Documentation described installer-managed dependencies, managed checkout, virtual environment, and global `hermes` command setup. - 2026: Official skills documentation described background self-improvement review and optional write approval for skill changes. ### Related projects - Hermes Agent is related to autonomous coding and task agents such as Claude Code, Codex-style terminal agents, OpenClaw, and other tool-calling shells. The README explicitly documents migration from OpenClaw. - Its skills model is related to agentskills.io and to the broader agent-memory pattern in which reusable procedures are stored outside the prompt and loaded only when relevant. ### Sources - GitHub README for scope, install model, provider support, and migration notes. - Official documentation home and installation page for product positioning and installer behavior. - Official skills and skills-catalog pages for self-improvement and bundled skill behavior. ## Security Notes No matching local secret-handling manifest was found for hermes-agent. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Other Package-Manager Records - winget - fathah.HermesDesktop: normalized package name match | Windows Package Manager source index: fathah.HermesDesktop from https://cdn.winget.microsoft.com/cache/source.msix - apk - hermes - 1.9-r10: installed executable or alias match | Alpine Linux edge package indexes: hermes from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Hermes is an anti-spam transparent SMTP proxy | https://hermes-project.com/ - apk - hermes-doc - 1.9-r10: installed executable or alias match | Alpine Linux edge package indexes: hermes-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Hermes is an anti-spam transparent SMTP proxy (documentation) | https://hermes-project.com/ - dnf - Hermes - 1.3.3-55.fc45: installed executable or alias match | Fedora Rawhide package metadata: Hermes from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Pixel format conversion library | http://web.archive.org/web/20040202225109/http://www.clanlib.org/hermes/ - dnf - Hermes-devel - 1.3.3-55.fc45: installed executable or alias match | Fedora Rawhide package metadata: Hermes-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Development libraries and header files for Hermes | http://web.archive.org/web/20040202225109/http://www.clanlib.org/hermes/ ## Combined YAML source View the package source record on GitHub. [combined/hermes-agent.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hermes-agent.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph