← all repositories
fathah/hermes-desktop

A desktop wrapper that actually earns its keep

Electron GUI for Hermes Agent, an AI assistant that can message you on 16 platforms and won't stop learning.

11k stars TypeScript Chat AssistantsAgents
hermes-desktop
Velocity · 7d
+165
★ / day
Trend
steady
star history

What it does Hermes Desktop is an Electron app that installs, configures, and chats with Hermes Agent — a self-improving AI assistant with tool use and a closed learning loop. Instead of wrestling with CLI setup, you get a guided installer, then a GUI for chat, session history, memory, skills, scheduled tasks, and messaging gateways. It stores Hermes in ~/.hermes and talks to it over SSE streaming at 127.0.0.1:8642, or connects to a remote Hermes API server if you prefer.

The interesting bit The breadth is almost comical: 22 slash commands, 14 toolsets, 16 messaging gateways (Telegram to iMessage to Home Assistant), cron scheduling with 15 delivery targets, and a 3D visual interface called “Hermes Office (Claw3d)” that the README mentions twice without explaining what it actually does. The app also tracks live token costs in the chat footer — a small detail that suggests someone actually uses this for real work.

Key highlights

  • Guided first-run install with dependency resolution (Git, uv, Python 3.11+)
  • 11 LLM providers including local endpoints (Ollama, vLLM, llama.cpp, LM Studio)
  • Session search via SQLite FTS5 with date-grouped history
  • Profile switching for isolated Hermes environments
  • Memory system with discoverable providers (Honcho, Mem0, RetainDB, etc.)
  • Auto-updater via electron-updater; i18n framework ready for translations
  • Test suite with Vitest covering SSE parser, IPC handlers, preload API

Caveats

  • Windows installer is unsigned — SmartScreen will complain
  • Fedora .rpm is unsigned and can’t auto-update (electron-updater limitation)
  • WSL install can hang waiting for sudo password with no TTY; tracked in #109
  • README warns: “in active development,” “some things might break”

Verdict Worth a look if you want a local AI assistant that can actually do things — message people, run code, browse the web, remember context — without living in a terminal. Skip it if you need production stability or a simple chatbot; this is a Swiss Army knife with some blades still being sharpened.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.