explaingit

fathah/hermes-desktop

4,600TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A native desktop app for Mac, Windows, and Linux that provides a graphical interface for the Hermes AI agent, supporting chat, scheduling, memory editing, and connections to 16 messaging platforms.

Mindmap

mindmap
  root((Hermes Desktop))
    What It Does
      Chat with AI agent
      Streaming responses
      Markdown and code highlighting
    AI Providers
      OpenAI
      Anthropic
      Groq
      Ollama local models
    Features
      Recurring task scheduling
      Memory editor
      Persona editor
    Messaging Gateways
      Telegram
      Discord
      Slack
      WhatsApp
    Platforms
      macOS
      Windows
      Linux
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Chat with an AI agent through a desktop window using your existing OpenAI or Anthropic API key.

USE CASE 2

Set up recurring scheduled tasks that the Hermes agent runs automatically on your computer.

USE CASE 3

Connect the agent to Telegram or Discord so it can send and receive messages on those platforms.

USE CASE 4

Manage separate profiles with isolated settings, chat history, and memory for different agent setups.

Tech stack

TypeScriptElectronOllama

Getting it running

Difficulty · easy Time to first run · 30min

Requires an API key for a cloud provider or a local Ollama install, the app handles Hermes Agent dependency installation automatically on first launch.

Free to use, modify, and distribute for any purpose, with no restrictions other than keeping the copyright notice.

In plain English

Hermes Desktop is a native desktop application that serves as a graphical front-end for Hermes Agent, an AI assistant from Nous Research. Instead of running the agent through a command line, this app gives you a full window-based interface for installing, configuring, and chatting with the agent on your own computer or pointing at a remote server. On first launch the app walks you through installing the Hermes Agent software itself, handling dependencies automatically. After that it gives you a chat window with streaming responses, markdown rendering, syntax highlighting, and a token usage display showing how much each conversation costs. There are over twenty slash commands you can type during a conversation to switch modes or trigger specific behaviors, such as web search, code execution, shell access, and image generation. The app supports connecting to a wide range of AI model providers including OpenAI, Anthropic, Google Gemini, Groq, xAI, and others, as well as locally running models through tools like Ollama or LM Studio. You can save named model configurations and switch between them. Separate profiles let you keep distinct agent setups with isolated settings, history, and memory. Beyond chat, there is a scheduling system for setting up recurring tasks, a memory editor for viewing and adjusting what the agent remembers about you, and a persona editor for customizing the agent's personality. Sixteen different messaging gateways can be connected so the agent can send and receive messages through platforms like Telegram, Discord, Slack, WhatsApp, and Email. Installation packages are available for macOS, Windows, and Linux in several formats. The app is in active development and the README notes that features may change. It is open-source under the MIT license.

Copy-paste prompts

Prompt 1
I installed Hermes Desktop and want to connect it to my local Ollama model. Walk me through setting up the model provider in the app settings.
Prompt 2
Show me how to use the Hermes Desktop scheduling feature to set up a daily task that summarizes my emails.
Prompt 3
I want to connect Hermes Desktop to my Discord server so the agent responds to messages in a channel. What steps do I follow?
Prompt 4
How do I create a custom persona in Hermes Desktop and switch between it and the default agent personality?
Prompt 5
Give me a quick reference for the most useful slash commands in Hermes Desktop chat and what each one does.
Open on GitHub → Explain another repo

← fathah on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.