AI/TLDR

Hermes One

Native desktop app for installing, configuring and chatting with Hermes Agent

Assistants & ChatbotsOpen source
Language
TypeScript
License
MIT

Overview

Hermes One is a community-maintained native desktop application for Hermes Agent, the self-improving assistant from Nous Research. Instead of driving the agent's CLI by hand, the app walks you through install, provider setup and day-to-day usage in one window. It uses the official Hermes install script, keeps the agent in `~/.hermes`, and puts a GUI in front of chat, sessions, profiles, memory, skills, tools, scheduling and messaging gateways.

On first launch it asks whether you want to run Hermes locally or connect to a remote Hermes API server. In local mode it checks `~/.hermes`, runs the official installer and resolves dependencies (Git, uv, Python 3.11+), then talks to the agent over `http://127.0.0.1:8642` with SSE streaming. In remote mode it validates a URL plus API key and skips the local install entirely, using the same streaming protocol.

The chat surface renders tool progress, markdown and syntax highlighting as the stream arrives, tracks prompt and completion tokens with a live cost readout, and exposes 22 slash commands (`/new`, `/web`, `/browse`, `/code`, `/shell`, `/compact`, `/model`, `/memory`, `/persona` and more). Sessions are searchable with SQLite FTS5, profiles isolate separate Hermes environments, and the Settings screen carries backup/restore, a log viewer and a debug dump. It is MIT-licensed, built on Electron with electron-updater for auto-updates, and ships an English locale with the i18n framework wired for community translations.

What it does

  • Guided first-run install of Hermes Agent with progress tracking and dependency resolution (Git, uv, Python 3.11+)
  • Local backend on 127.0.0.1:8642 or a remote Hermes API server reached with URL + API key
  • Multi-provider support — OpenRouter, Anthropic, OpenAI, Google, xAI, Nous Portal, Qwen, MiniMax, Hugging Face, Groq, plus local OpenAI-compatible endpoints (LM Studio, Ollama, vLLM, llama.cpp)
  • Streaming chat with tool progress, markdown, syntax highlighting, live token counts and 22 slash commands
  • Session management with SQLite FTS5 full-text search and date-grouped history; profile switching with isolated config
  • 14 toolsets (web, browser, terminal, file, code execution, vision, image gen, TTS, skills, memory, session search, clarify, delegation, MoA, task planning)
  • Memory browser with discoverable providers (Honcho, Hindsight, Mem0, RetainDB, Supermemory, ByteRover) and a SOUL.md persona editor
  • Cron scheduler with 15 delivery targets and 16 messaging gateways including Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, SMS and Home Assistant

Getting started

Hermes One ships prebuilt installers for macOS, Windows and Linux from hermesone.org and the GitHub releases page. It installs Hermes Agent for you on first run, so no prior CLI setup is needed.

Install the desktop app

Download the installer for your platform. On Windows the installer is not code-signed, so SmartScreen warns on first launch — choose "More info" then "Run anyway". On Fedora, install the RPM directly; it is not GPG-signed, so append --nogpgcheck if your system enforces signature checks.

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

Choose local or remote

On first launch the app asks how to reach Hermes. Local mode checks ~/.hermes, runs the official Hermes installer if the agent is missing, and resolves Git, uv and Python 3.11+. Remote mode asks for a Hermes API URL and key, validates the connection and skips the install.

Connect a model provider

Pick a provider or a local OpenAI-compatible endpoint and paste the key. The app writes the credentials through Hermes' own config files, so the CLI and the GUI stay in sync. Saved model configurations can be managed per provider on the Models screen.

Work from the chat screen

Talk to the agent and drive it with slash commands; token usage and cost show in the chat footer.

texttext
/tools      # enable or disable toolsets
/skills     # browse and install skills
/memory     # inspect and edit memory entries
/usage      # prompt + completion tokens and cost
/compact    # compress the running conversation

Automate and connect

Use the Schedules screen to build cron jobs (minutes, hourly, daily, weekly or a custom expression) with a delivery target, and the Gateway screen to wire the agent into Telegram, Discord, Slack, Matrix, email, SMS, Feishu, WeCom or a webhook.

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

When to use it

  • Reach for it when you want Hermes Agent running on a laptop without managing its CLI, installer and config files by hand
  • Reach for it to give a self-hosted agent a chat UI with session search, persona editing and visible tool progress
  • Reach for it when the agent should answer from messaging apps — Telegram, Discord, Slack, WhatsApp, Signal or email — through one configuration screen
  • Reach for it to run scheduled agent jobs and have the results delivered somewhere you already read

How Hermes One compares

Hermes One alongside other open-source assistants & chatbots tools AI/TLDR tracks, ranked by GitHub stars.

ToolStarsWhat it does
OpenClaw★ 390kOpenClaw is a self-hosted personal AI assistant that answers you on WhatsApp, Telegram, Slack, Discord, and many other channels, with voice and a live visual canvas.
Hermes Agent★ 247kA self-improving personal AI agent from Nous Research that builds skills from experience, remembers across sessions, and reaches you on Telegram, Discord, Slack, and more.
Odysseus★ 87.4kA self-hosted AI workspace that puts chat, agents, deep research, documents, email, notes, tasks and calendar behind one Docker Compose stack, over local or API models.
CowAgent★ 47.1kA self-hosted assistant that plans and executes tasks with built-in file, terminal, browser and search tools, and answers across a web console plus a dozen messaging platforms.
AstrBot★ 40.7kAn all-in-one agent chatbot platform that puts LLM conversations, tools, knowledge bases and a plugin marketplace inside messaging apps like Telegram, Slack, Discord, QQ and Feishu.
OpenHuman★ 39.9kA local-first desktop personal AI for macOS, Windows and Linux that keeps a compressed memory tree on your machine and orchestrates checkpointed research and automation workflows.
MindsHub★ 39.8kAn agent workspace for knowledge work and software development that runs swappable open-source agent harnesses against your choice of frontier or open models.
Hermes One★ 14.3kNative desktop app for installing, configuring and chatting with Hermes Agent