Is hermes-desktop still maintained?

Yes, active. Last change 3 days ago. Latest release v0.7.8, 3 days ago.

How widely used is hermes-desktop?

Some track record. 15k stars, 8 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install hermes-desktop on macOS (fathah/hermes-desktop) · gitmanual

How to install on macOS

fathah/hermes-desktop

Desktop Companion for Hermes Agent

Node.jsVite#ai#ai-agent#autonomous-agents#chatbot

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change 3 days ago. Latest release v0.7.8, 3 days ago.
How widely used?: Some track record15k stars, 8 months old. Get it from the official repo and read what it installs.

Difficulty: Easy
Time: about 5 min
Stars: ★ 14,577
Activity: Updated this month

Saved setup from just now

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗hermesone.orgThe project's own site.

Heads-upBuilding it yourself? It also needs 4 settings in .env (2 secret).

Download for macOS

Hermes Desktop v0.7.8 · 11/12/2026 ↗

hermes-desktop-0.7.8-arm64.dmg

dmg · Apple Silicon · 191.9 MB · 86 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/fathah/hermes-desktop/releases/download/v0.7.8/hermes-desktop-0.7.8-arm64.dmg"
open "hermes-desktop-0.7.8-arm64.dmg"

Other macOS downloads (3)

hermes-desktop-0.7.8-arm64-mac.zip

zip · Apple Silicon · 191.4 MB · 301 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/fathah/hermes-desktop/releases/download/v0.7.8/hermes-desktop-0.7.8-arm64-mac.zip"
unzip "hermes-desktop-0.7.8-arm64-mac.zip"

hermes-desktop-0.7.8-x64.dmg

dmg · Intel · 198.8 MB · 45 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/fathah/hermes-desktop/releases/download/v0.7.8/hermes-desktop-0.7.8-x64.dmg"
open "hermes-desktop-0.7.8-x64.dmg"

hermes-desktop-0.7.8-x64-mac.zip

zip · Intel · 198.3 MB · 55 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/fathah/hermes-desktop/releases/download/v0.7.8/hermes-desktop-0.7.8-x64-mac.zip"
unzip "hermes-desktop-0.7.8-x64-mac.zip"

Use it in your own project

This is a library: you add it to your code rather than opening an app.

For your own code: JSNeeds Node.js

npm install hermes-desktop

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 8 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 22runtime
1×npm package manager

4× settings in .env

VITE_ANALYTICS_BASE_URL
VITE_ANALYTICS_API_KEYsecret
MAIN_VITE_HERMES_API_URL
MAIN_VITE_HERMES_API_KEYsecret

Share this manual

Is this your repo?

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

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

Good to know

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.

Details

License: MIT
Open issues: 335
Branch: main

package.json scripts (24)

formatprettier --write .
linteslint --cache --max-warnings=0 .
audit:prodnode scripts/audit-production-dependencies.mjs
testvitest run --maxWorkers=4
test:coveragevitest run --coverage
test:sandboxpowershell -NoProfile -ExecutionPolicy Bypass -File scripts/hermes-sandbox.ps1 test
test:live-visualnode scripts/drive-live-regression-suite.js
typecheck:nodetsc --noEmit -p tsconfig.node.json --composite false
typecheck:webtsc --noEmit -p tsconfig.web.json --composite false
typechecknpm run typecheck:node && npm run typecheck:web
typecheck:sandboxpowershell -NoProfile -ExecutionPolicy Bypass -File scripts/hermes-sandbox.ps1 typecheck
startelectron-vite preview
develectron-vite dev
dev:sandboxpowershell -NoProfile -ExecutionPolicy Bypass -File scripts/hermes-sandbox.ps1 dev
sandbox:sync-configpowershell -NoProfile -ExecutionPolicy Bypass -File scripts/hermes-sandbox.ps1 sync-config
dev:freshHERMES_HOME=$(mktemp -d -t hermes-fresh) electron-vite dev
buildnpm run typecheck && electron-vite build
postinstallinstall-electron --no && electron-builder install-app-deps
build:unpacknpm run build && electron-builder --dir
build:winnpm run build && electron-builder --win
build:macelectron-vite build && electron-builder --mac
build:linuxelectron-vite build && electron-builder --linux
build:rpmnpm run build && electron-builder --linux rpm
test:watchvitest

Files we read (8)

.env.example

.github/workflows/beta-release.yml

.github/workflows/ci.yml

.github/workflows/native-release-acceptance.yml

.github/workflows/release.yml

Development.md

README.md

package.json

1,289 files in the repo

Contact

fathah/hermes-desktop

Before you start

Your setup manual for hermes-desktop

What's inside

Handy for

Yes, it installs on your macOS

Start here

Download for macOS

Use it in your own project

Did you get it running?

Still stuck? Get a written guide

Yes, it installs on your macOS

Start here

Download for macOS

Use it in your own project

Did you get it running?

Still stuck? Get a written guide

More like hermes-desktop that run on macOS