Repolode
Submit
fathah

fathah/hermes-desktop

A community-maintained native desktop app for installing, configuring, and chatting with the Hermes Agent AI assistant.

View on GitHubWebsite
Stars
14,548
Forks
1,632
Open issues
306
Last commit
25 days ago

What is it?

Hermes Desktop is a GUI companion for Hermes Agent, a self-improving AI assistant with tool use and multi-platform messaging. Instead of managing the CLI by hand, the app walks through installation, provider setup, and daily use in one window. It runs the official Hermes install script and stores data in ~/.hermes.

The app covers chat with streaming responses, session search and history, profile switching, memory and persona editing, skills, toolset toggles, cron-style scheduled tasks, and messaging gateway configuration. It can run Hermes locally on 127.0.0.1:8642 or connect to a remote Hermes API server with a URL and API key. Supported providers include OpenRouter, Anthropic, OpenAI, Gemini, Groq, and local OpenAI-compatible servers such as Ollama and LM Studio.

API keys are stored in ~/.hermes/.env by default, and an opt-in command provider can resolve them from tools such as pass, secret-tool, or 1Password CLI. The project is MIT licensed, built with TypeScript, and is not affiliated with Nous Research.

Key features

  • 01Guided first-run install of Hermes Agent with provider setup in the GUI
  • 02Local or remote Hermes backend, with remote connections via URL and API key
  • 03Streaming chat with tool progress, markdown rendering, and token usage display
  • 04Session search and history, plus profile switching with isolated config
  • 05Cron-based scheduled tasks and configuration for multiple messaging gateways

Use cases

  • Setting up Hermes Agent on a desktop without working in the terminal
  • Chatting with a local model served by Ollama or LM Studio through one interface
  • Managing several isolated Hermes profiles for different projects
  • Connecting a desktop client to a remote Hermes API server

Quick start

  1. 1

    Download the desktop app for your operating system from hermesone.org or GitHub Releases

  2. 2

    Fedora users: install the downloaded .rpm package

    sudo dnf install ./hermes-desktop-<version>.rpm
  3. 3

    Developers: clone this repository and follow the Contributing Guide to run the app in development

Things to know

  • The project is in active development, so features may change and some things may break.
  • The Windows installer is not code-signed, so SmartScreen will warn on first launch.
  • The Fedora .rpm is not GPG-signed and does not support auto-update.
  • Local mode requires Git, uv, and Python 3.11+ to be resolved during install.

In collections

Open-source AI agent frameworks & appsAI chatbots & chat clientsDesktop GUI apps & toolkits

Topics

#ai-agent#llm#desktop-app#electron#chatbot#typescript#ai#autonomous-agents#hermes

FAQ

What is hermes-desktop?
A community-maintained native desktop app for installing, configuring, and chatting with the Hermes Agent AI assistant. Hermes Desktop is a GUI companion for Hermes Agent, a self-improving AI assistant with tool use and multi-platform messaging. Instead of managing the CLI by hand, the app walks through installation, provider setup, and daily use in one window. It runs the official Hermes install script and stores data in ~/.hermes.
Is hermes-desktop free to use? What license does it have?
hermes-desktop is open source under the MIT license. Check the license terms before using it in commercial products.
Is hermes-desktop still maintained?
Actively maintained. The last commit to hermes-desktop was on Oct 13, 2026.
What can I use hermes-desktop for?
Setting up Hermes Agent on a desktop without working in the terminal Chatting with a local model served by Ollama or LM Studio through one interface Managing several isolated Hermes profiles for different projects Connecting a desktop client to a remote Hermes API server
How do I install hermes-desktop?
Download the desktop app for your operating system from hermesone.org or GitHub Releases Fedora users: install the downloaded .rpm package: sudo dnf install ./hermes-desktop-<version>.rpm Developers: clone this repository and follow the Contributing Guide to run the app in development
Where can I get hermes-desktop?
The source code and installation instructions are on GitHub: https://github.com/fathah/hermes-desktop

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects