# Install hermes-agent with Homebrew, apk, dnf

Self-improving AI agent that creates skills from experience. Version 2026.7.7 via Homebrew; verified 2026-07-08.

## 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/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

## Package facts

- **Package key:** brew:hermes-agent
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/hermes-agent>
- **Version:** 2026.7.7
- **Source summary:** Self-improving AI agent that creates skills from experience
- **Homepage:** <https://hermes-agent.nousresearch.com>
- **Repository:** <https://github.com/NousResearch/hermes-agent>
- **Upstream docs:** <https://hermes-agent.nousresearch.com/docs>
- **License:** MIT
- **Source archive:** <https://github.com/NousResearch/hermes-agent/archive/refs/tags/v2026.7.7.tar.gz>
- **Last updated:** 2026-07-08T03:44:44Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- hermes (cli)
- hermes-acp (cli)
- hermes-agent (cli)
- hermes (alias)
- hermes-acp (alias)
- hermes-agent (alias)

## Dependencies

- certifi
- cryptography
- libyaml
- pillow
- pydantic
- python@3.14

## Build dependencies

- pkgconf
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2026.7.7
- Package-manager updated: 2026-07-08
- Local data: ok
- Upstream repository: https://github.com/NousResearch/hermes-agent
- Upstream latest detected: v2026.7.7 (current)
## 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.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hermes-agent
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- 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-52.fc44: 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/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Pixel format conversion library | http://web.archive.org/web/20040202225109/http://www.clanlib.org/hermes/
- dnf - Hermes-devel - 1.3.3-52.fc44: 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/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Development libraries and header files for Hermes | http://web.archive.org/web/20040202225109/http://www.clanlib.org/hermes/


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [fabric-ai](https://www.automicvault.com/pkg/brew/fabric-ai/) - Shares av.db curated category or tags: automation, cli, developer-tools, llm.
- [gptscript](https://www.automicvault.com/pkg/brew/gptscript/) - Shares av.db curated category or tags: automation, cli, developer-tools, llm.
- [kagent](https://www.automicvault.com/pkg/brew/kagent/) - Shares av.db curated category or tags: automation, cli, developer-tools, llm.
- [letta-code](https://www.automicvault.com/pkg/brew/letta-code/) - Shares av.db curated category or tags: ai-agent, cli, developer-tools, memory.
- [picoclaw](https://www.automicvault.com/pkg/brew/picoclaw/) - Shares av.db curated category or tags: ai-agent, cli, developer-tools.
- [ahoy](https://www.automicvault.com/pkg/brew/ahoy/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [all-repos](https://www.automicvault.com/pkg/brew/all-repos/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [apify-cli](https://www.automicvault.com/pkg/brew/apify-cli/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [gptme](https://www.automicvault.com/pkg/brew/gptme/) - Both packages touch the same language runtime or ecosystem. Shared terms: agent, ai, certifi, cli, cryptography.
- [kimi-cli](https://www.automicvault.com/pkg/brew/kimi-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: agent, ai, ai-agent, certifi, cli.
- [oterm](https://www.automicvault.com/pkg/brew/oterm/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, certifi, cli, cryptography, developer.

## Combined YAML source

View the package source record on GitHub. [combined/hermes-agent.yml](https://github.com/automic-vault/db/blob/main/combined/hermes-agent.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
