hermes-desktop README

The project's README from github.com/fathah/hermes-desktop. As one markdown file: README.md.

HERMES DESKTOP

Twitter Discord License: MIT Releases Stars Downloads Downloads

English · 简体中文 · 日本語 · Español (LATAM)

Star History Rank

This project is in active development. Features may change, and some things might break. If you run into a problem or have an idea, open an issue. Contributions are welcome!

Hermes One is a community maintained native desktop app for installing, configuring, and chatting with Hermes Agent — a self-improving AI assistant with tool use, multi-platform messaging, and a closed learning loop.

Instead of managing the CLI by hand, the app walks through install, provider setup, and day-to-day usage in one place. It uses the official Hermes install script, stores Hermes in ~/.hermes, and gives you a GUI for chat, sessions, profiles, memory, skills, tools, scheduling, messaging gateways, and more.

ko-fi

Sponsors

Want to appear here?

Click to collapse
Atlas Cloud Atlas Cloud is a full-modal, OpenAI-compatible AI inference platform. Use it in Hermes One by selecting Atlas Cloud as your provider. The base URL is pre-configured automatically.
Greptile Greptile is an AI code reviewer. It reviews and tests pull requests with full context of the codebase. It catches bugs, flags regressions, and leaves inline review comments on every PR automatically.

Install

Download Now

Windows

Windows users: The installer is not code-signed. Windows SmartScreen will warn on first launch — click "More info" → "Run anyway".

WSL users: If the installer stalls at Switching to root user to install dependencies..., Playwright is waiting for a sudo password that has no TTY to read from. Grant passwordless sudo for the install, then revert when finished:

echo "$USER ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/hermes-install
# …re-run the installer; once it finishes:
sudo rm /etc/sudoers.d/hermes-install

Tracked in #109.

Fedora (RPM) 
sudo dnf install ./hermes-desktop-<version>.rpm

Fedora users: The .rpm is not GPG-signed. If your system enforces signature checking, append --nogpgcheck to the install command. Auto-update is not supported for .rpm builds (limitation of electron-updater); reinstall the new .rpm to update.

Preview

Chat
Chat		 Profiles
Profiles
Models
Models		 Providers
Providers
Tools
Tools		 Discover
Skills
Schedules
Schedules		 Gateway
Gateway
Persona
Persona		 Kanban
Kanban
Office
Office		 Settings
Settings

Features

How It Works

On first launch, the app:

  1. Asks whether you want to run Hermes locally or connect to a remote Hermes API server.
  2. Local mode: checks whether Hermes is already installed in ~/.hermes; if not, runs the official Hermes installer with dependency resolution (Git, uv, Python 3.11+).
  3. Remote mode: prompts for the remote API URL and API key, validates the connection, and skips local install.
  4. Prompts for an API provider or local model endpoint.
  5. Saves provider config and API keys through Hermes config files.
  6. Launches the main workspace once setup is complete.

In local mode, chat requests go through http://127.0.0.1:8642 with SSE streaming. In remote mode, the app talks to your configured remote URL with the same streaming protocol. The desktop app parses the stream in real time, rendering tool progress, markdown content, and token usage as it arrives.

Screens

Screen Description
Chat Streaming conversation UI with slash commands, tool progress, and token tracking
Sessions Browse, search, and resume past conversations
Agents Create, delete, and switch between Hermes profiles
Skills Browse, install, and manage bundled and installed skills
Models Manage saved model configurations per provider
Memory View/edit memory entries, user profile, and configure memory providers
Soul Edit the active profile's persona (SOUL.md)
Tools Enable or disable individual toolsets
Schedules Create and manage cron jobs with delivery targets
Gateway Configure and control messaging platform integrations
Office Claw3d visual interface setup and management
Settings Provider config, credential pools, backup/import, log viewer, network settings, theme

Supported Providers

Sponsors

Provider Notes
Atlas Cloud OpenAI-compatible gateway — DeepSeek, Qwen, GLM, Kimi, MiniMax and more (atlascloud.ai)

LLM Providers

Provider Notes
OpenRouter 200+ models via single API (recommended)
Anthropic Direct Claude access
OpenAI Direct GPT access
Google (Gemini) Google AI Studio
xAI (Grok) Grok models
Nous Portal Free tier available
Qwen QwenAI models
MiniMax Global and China endpoints
Hugging Face 20+ open models via HF Inference
Groq Fast inference (voice/STT)
Local/Custom Any OpenAI-compatible endpoint

Local presets are included for LM Studio, Atomic Chat, Ollama, vLLM, and llama.cpp.

Messaging Platforms

Telegram, Discord, Slack, WhatsApp, Signal, Matrix/Element, Mattermost, Email (IMAP/SMTP), SMS (Twilio & Vonage), iMessage (BlueBubbles), DingTalk, Feishu/Lark, WeCom, WeChat (iLink Bot), Webhooks, and Home Assistant.

Tool Integrations

Exa Search, Parallel API, Tavily, Firecrawl, FAL.ai (image generation), Honcho, Browserbase, Weights & Biases, and Tinker.

First-Time Setup

When the app opens for the first time, it will either detect an existing Hermes installation or offer to install it for you.

Supported setup paths in the UI:

Local presets are included for:

Hermes files are managed in:

Secrets provider

By default, API keys live in ~/.hermes/.env (the env provider). No configuration is needed — this is byte-for-byte the historical behavior, and nothing changes for you.

If you'd rather not keep keys in a plaintext .env, the opt-in command provider resolves them by running a helper command you configure. Resolution order everywhere is: process.env → .env → provider → unset.

Per-key helper (the requested key name arrives as $HERMES_SECRET_KEY):

# ~/.hermes/config.yaml
secrets:
  provider: command
  command: secret-tool lookup hermes "$HERMES_SECRET_KEY"

Or a helper that dumps a dotenv blob (e.g. a vault that unseals into tmpfs):

secrets:
  provider: command
  command: "cat /run/user/1000/hermes-secrets.env"

The helper's stdout may be either a single bare value (per-key helpers) or KEY=VALUE lines (dotenv dumps); both shapes are auto-detected.

Vault / secret manager integration (no TPM required)

The command provider is vault-agnostic — it runs whatever helper you configure and reads its stdout. The helper is the only thing that needs to talk to your secret store. If you don't have a TPM-sealed keyfile, any of these work without code changes to Hermes:

The point: any helper that prints a value (per-key) or a dotenv blob (list-mode) on stdout will work, and Hermes imposes a 3-second timeout and 1 MiB output cap on the helper so a misbehaving one can't wedge the app. The provider makes no assumptions about TPM, FIDO2, smart cards, or platform keychains.

Security model:

Source of truth: src/main/secrets/.

Notes

Contributing

Contributions are welcome! Check out the Contributing Guide to get started. If you're not sure where to begin, take a look at the open issues. Found a bug or have a feature request? File an issue.

This repo is not affiliated to Nous Research. This is a community maintained project.

For the core agent, docs, and CLI workflows, see the main Hermes Agent repository:

hermes-desktop (fathah/hermes-desktop)

Searching Database…

14.4K ·GitHub
Hermes-desktop
Что это такое?Hermes One — поддерживаемое сообществом нативное десктоп-приложение для установки, настройки и общения с Hermes Agent — самообучающимся AI-ассистентом с использованием инструментов, мультиплатформенным обменом сообщениями и замкнутым циклом обучения.
Это отдельный AI или десктоп-оболочка вокруг CLI-версии Hermes Agent?Это GUI-компаньон, а не самостоятельный AI: поведение агента и выполнение инструментов обеспечивает вышестоящий проект Hermes Agent, а приложение добавляет экраны установки, настройки провайдеров, чата, сессий, памяти, навыков и планировщика.
Как его запустить?Установите десктоп-приложение и запустите его: при первом запуске оно обнаружит уже установленный Hermes или выполнит официальный установщик Hermes (который подтянет Git, uv, Python 3.11+), а затем в GUI проведёт вас через настройку провайдера.
Мне нужен платный API-ключ или можно работать на локальных моделях?И то и другое. Поддерживаются OpenRouter (более 200 моделей, рекомендуется), Anthropic, OpenAI, Gemini, Grok, Qwen, Groq и другие — или любой локальный сервер, совместимый с OpenAI, например Ollama, LM Studio, vLLM или llama.cpp, которому API-ключ не нужен.
Есть ли подводные камни при установке, о которых стоит знать?Несколько: установщик для Windows не подписан, поэтому SmartScreen выдаст предупреждение (выберите «Подробнее» → «Выполнить в любом случае»), а .rpm для Fedora не подписан GPG-ключом — добавьте --nogpgcheck. Сборки .rpm также не умеют автообновляться, поэтому для обновления придётся переустанавливать приложение.
Какие операционные системы поддерживаются?Windows, macOS и Linux — это приложение на Electron. В руководствах по установке в README отдельно описаны особенности Windows и Fedora (RPM), а обновления доставляются через electron-updater (кроме сборок .rpm).
Агент должен работать на моём компьютере или можно подключить приложение к удалённому серверу?Как угодно. В локальном режиме приложение обращается к Hermes на 127.0.0.1:8642; в удалённом режиме указываются URL и API-ключ удалённого сервера Hermes API, соединение проверяется, и локальная установка вообще не требуется.
Где хранятся мои API-ключи и история чатов?По умолчанию ключи хранятся в открытом виде в ~/.hermes/.env; по желанию можно включить командный провайдер, который будет брать их из KeePassXC, GnuPG, pass или 1Password — правда, только на POSIX-системах, Windows остаётся на .env. История чатов хранится в локальной базе SQLite (~/.hermes/state.db).
Что агент реально умеет делать прямо из окна чата?22 слэш-команды (/web, /image, /code, /shell, /usage, /model...) и 14 наборов инструментов — браузер, терминал, работа с файлами, выполнение кода, компьютерное зрение, генерация изображений, TTS, планирование задач и другое — с потоковыми ответами, показом хода выполнения инструментов и учётом токенов и затрат в реальном времени.
Могу ли я писать агенту через Telegram или Discord вместо приложения?Да — на экране Gateway настраивается любая из 16 платформ: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, SMS через Twilio или Vonage, iMessage, DingTalk, Feishu, WeCom, WeChat, Webhooks и Home Assistant. Задания в стиле cron могут доставлять результаты на 15 целей.
Это официальное приложение Hermes от Nous Research?Нет — в README сказано, что репозиторий не связан с Nous Research; проект поддерживается сообществом. При этом он зависит от вышестоящего проекта Hermes Agent, который устанавливает и запускает под капотом.
Агент помнит что-то между разговорами?Да — есть отдельный экран Memory для просмотра и редактирования записей памяти и памяти профиля пользователя, с подключаемыми провайдерами вроде Honcho, Mem0, RetainDB, Supermemory и ByteRover. Прошлые сессии доступны для поиска (SQLite FTS5) и можно продолжить с того места, где вы остановились.
What are similar projects?hermes-agent, brigade, Raven, opensquilla, nullclaw, eliza, openclaw, nanobot
Which topics is it in?hermes, cron, hermes-agent, slack, messaging, discord, installer, telegram, autonomous-agents, memory, openai-compatible, local-llm
Creator
fathah
Size
35.6 MB
Stars
14.4K
Updated
CommitOct 13Releasev0.7.7Sep 04
Age
6mo
Commits · 90 Days