Is hermes-agent still maintained?

Yes, active. Last change today. Latest release v0.23.0, yesterday.

Can I trust hermes-agent?

Widely used. 261k stars, 1 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to install hermes-agent on macOS (NousResearch/hermes-agent) · gitmanual

How to install on macOS

NousResearch/hermes-agent

The agent that grows with you

Node.jsPython#ai#ai-agent#ai-agents#anthropic

Difficulty: Moderate
Time: about 15 min
Stars: ★ 261,339
Activity: Updated this month
License: MIT
Open issues: 53,478
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change today. Latest release v0.23.0, yesterday.
Can I trust it?: Widely used261k stars, 1 years old, by an organization. As with any download, get it from the official repo.

Start here

Website ↗hermes-agent.nousresearch.comThe project's own site.Docs ↗hermes-agent.nousresearch.comLinked from the README.

Setup script in the repo

The maintainers included setup-hermes.sh. Run it from the cloned folder after reading it.

bash setup-hermes.sh

Also: scripts/install.sh, setup-hermes.ps1, scripts/install.cmd, scripts/install.ps1

Will it work on my device?

Yes, it installs on your macOS

The README gives a install script install for macOS.

Checking for

macOS Windows Linux

Install with a package manager

install script

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 26runtime
1×Python 3.14runtime
1×pnpm package manager
1×uv package manager
1×PostgreSQL service

11× settings in .env

TERMINAL_MODAL_IMAGE
TERMINAL_TIMEOUT
TERMINAL_LIFETIME_SECONDS
BROWSERBASE_PROXIES
BROWSERBASE_ADVANCED_STEALTH
BROWSER_SESSION_TIMEOUT
BROWSER_INACTIVITY_TIMEOUT
WEB_TOOLS_DEBUG
VISION_TOOLS_DEBUG
MOA_TOOLS_DEBUG
IMAGE_TOOLS_DEBUG

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/NousResearch/hermes-agent/badge.svg)](https://gitmanual.com/NousResearch/hermes-agent)

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: debian:trixie-20261020@sha256:4c25275446ca371766b8b093c696782eabce06263fccacb8d5d813b3dc44b308).
justfile found — run just --list to see available tasks.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: apps/bootstrap-installer/package.json, apps/bootstrap-installer/src-tauri/Cargo.toml, apps/desktop/electron/find-in-page-native-fixture/package.json, apps/desktop/electron/preview-activity-native-fixture/package.json and 11 more

package.json scripts (15)

preinstallnode -e "const ua=(process.env.npm_config_user_agent||'').split(' ')[0];let pin,why;try{pin=require('./pm/lock.json').packages.pnpm.version}catch(e){why=e.code||e.message}if(typeof pin==='string'&&ua==='pnpm/'+pin)process.exit(0);console.error(typeof pin==='string'?'This repository installs with pnpm '+pin+' (pm/lock.json), found '+(ua||'no user agent')+': source ./activate (PowerShell: . ./activate.ps1) provides it, then run pnpm install --frozen-lockfile':'pm/lock.json pins no pnpm'+(why?' ('+why+')':'')+': restore it from git');process.exit(1)"
postinstallecho '✅ Node dependencies installed. Run: python run_agent.py --help'
install:rootpnpm install --filter .
install:webpnpm install --filter web...
install:tuipnpm install --filter hermes-tui...
install:desktoppnpm install --filter hermes...
audit:rootpnpm audit --filter .
audit:webpnpm audit --filter web
audit:tuipnpm audit --filter hermes-tui
audit:fix:rootpnpm audit --fix --filter .
audit:fix:webpnpm audit --fix --filter web
audit:fix:tuipnpm audit --fix --filter hermes-tui
checkpnpm -r check
fixpnpm -r fix
preparenode -e "const {existsSync}=require('fs');const {spawnSync}=require('child_process');if(existsSync('.git'))spawnSync('lefthook',['install'],{stdio:'inherit',shell:true})"

Files we read (18)

.env.example

.github/workflows/bootstrap-installer-build.yml

.github/workflows/catalog-tests.yml

.github/workflows/ci-review-comment.yml

.github/workflows/ci.yaml

.github/workflows/docs-site-checks.yml

.github/workflows/js-tests.yml

.nvmrc

.python-version

CONTRIBUTING.md

Dockerfile

README.md

docker-compose.yml

justfile

package.json

pnpm-workspace.yaml

pyproject.toml

setup.py

Branch main · 22,777 files in the repo