Hermes Desktop [Wiki]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== Hermes Desktop ======

//Vytvořeno: **14.6.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/fathah/hermes-desktop|Hermes Desktop]] je nativní desktopová aplikace pro instalaci, konfiguraci a používání [[https://github.com/NousResearch/hermes-agent|Hermes Agentu]] přes grafické rozhraní. Nejde o samostatného agenta ani náhradu core projektu, ale o GUI vrstvu, která obaluje instalaci, poskytovatele modelů, chat, sessions, profily, paměť, tools, skills, plánované úlohy a messaging gateway.

===== Vztah k Hermes Agentu =====

Hermes Desktop stojí nad Hermes Agentem. Podle README používá oficiální instalační skript Hermes Agentu, ukládá data do ''~/.hermes'' a po prvním spuštění provede uživatele základním nastavením.

Aplikace podporuje dva způsoby připojení:

  * **Lokální režim** – ověří, jestli je Hermes nainstalovaný v ''~/.hermes'', případně ho nainstaluje. Chat potom běží přes lokální backend na ''http%%://%%127.0.0.1:8642''.
  * **Vzdálený režim** – místo lokální instalace se připojí na remote Hermes API server pomocí URL a API klíče.

Prakticky je Hermes Desktop vhodný hlavně pro situace, kdy dává Hermes Agent smysl, ale nechceš všechno spravovat ručně přes CLI.

===== Co aplikace nabízí =====

Z README projektu vychází, že hlavní hodnota je v grafické správě věcí, které by jinak bylo potřeba nastavovat ručně:

  * streaming chat UI se slash příkazy, průběhem toolů, markdownem a zvýrazněním syntaxe,
  * správu sessions včetně vyhledávání v historii,
  * profily pro oddělená Hermes prostředí,
  * nastavení providerů a uložených modelů,
  * přehled a zapínání toolsetů,
  * správu skills,
  * práci s persistentní pamětí a user profile memory,
  * editor persony přes ''SOUL.md'',
  * scheduled tasks přes cron builder,
  * konfiguraci messaging gateway,
  * backup, import, debug dump a log viewer v nastavení.

Desktop tedy řeší hlavně použitelnost a provozní správu Hermes Agentu. Core schopnosti agenta, tool execution a dlouhodobější agentní chování zůstávají navázané na samotný Hermes Agent.

===== První spuštění =====

Při prvním spuštění aplikace podle README:

  - Zeptá se, jestli má Hermes běžet lokálně, nebo jestli se má připojit ke vzdálenému API serveru.
  - V lokálním režimu ověří instalaci v ''~/.hermes'' a případně spustí instalaci závislostí.
  - Ve vzdáleném režimu vyžádá URL serveru a API key.
  - Nechá vybrat poskytovatele API nebo lokální model endpoint.
  - Uloží konfiguraci provideru a API klíče do Hermes konfiguračních souborů.
  - Otevře hlavní workspace.

Podporované setup cesty v UI jsou podle README hlavně OpenRouter, Anthropic, OpenAI a lokální OpenAI-kompatibilní endpoint. Lokální presety jsou uvedené pro LM Studio, Atomic Chat, Ollama, vLLM a llama.cpp.

===== Instalace a distribuce =====

Ke stažení odkazuje README na [[https://hermesagents.cc/|hermesagents.cc]] a zároveň má projekt běžné [[https://github.com/fathah/hermes-desktop/releases|GitHub Releases]]. V době zpracování byl poslední dostupný release ''v0.6.1''.

Projekt publikuje instalační balíky pro více platforem:

  * Windows installer a portable EXE,
  * macOS DMG a ZIP buildy,
  * Linux AppImage,
  * Debian balíček ''.deb'',
  * Fedora/RHEL balíček ''.rpm''.

Na co upozorňuje README:

  * Windows installer není code-signed, takže Windows SmartScreen může při prvním spuštění varovat.
  * Fedora ''.rpm'' není GPG-signed; pokud systém vyžaduje podpis, je potřeba použít ''--nogpgcheck''.
  * Auto-update není podporovaný pro ''.rpm'' buildy kvůli omezení ''electron-updater''.

===== Providers, gateway a integrace =====

README zmiňuje široký seznam podporovaných LLM providerů: OpenRouter, Anthropic, OpenAI, Google Gemini, xAI Grok, Nous Portal, Qwen, MiniMax, Hugging Face, Groq a lokální nebo vlastní OpenAI-kompatibilní endpointy.

Messaging gateway vrstva z README pokrývá Telegram, Discord, Slack, WhatsApp, Signal, Matrix/Element, Mattermost, e-mail přes IMAP/SMTP, SMS přes Twilio/Vonage, iMessage přes BlueBubbles, DingTalk, Feishu/Lark, WeCom, WeChat přes iLink Bot, Webhooks a Home Assistant.

Z praktického pohledu je důležité, že Hermes Desktop není jen chatovací okno. Je to i administrační UI pro provider credentials, modely, gateway a dlouhodobější běh agenta.

===== Tajemství a bezpečnost =====

README popisuje výchozí ukládání API klíčů do ''~/.hermes/.env''. Novější konfigurace zároveň podporuje volitelný ''command'' secrets provider, který umí získávat hodnoty z externího příkazu.

Použitelné scénáře z README:

  * ''secret-tool'' / libsecret,
  * ''pass'',
  * KeePassXC wrapper,
  * GnuPG,
  * Bitwarden CLI,
  * 1Password CLI,
  * vlastní chráněný env soubor.

To je relevantní hlavně u dlouhodobě běžícího agenta, protože desktopová aplikace spravuje API klíče, gateway integrace a lokální konfigurační soubory.

===== Vývoj =====

Projekt je postavený jako Electron aplikace nad Reactem a TypeScriptem. README uvádí tento stack:

  * Electron 39,
  * React 19,
  * TypeScript 5.9,
  * Tailwind CSS 4,
  * Vite 7 a electron-vite,
  * better-sqlite3 pro lokální historii sessions,
  * i18next,
  * Vitest.

Základní vývojové příkazy:

<code bash>
npm install
npm run dev
npm run lint
npm run typecheck
npm run test
npm run build
</code>

Platformní buildy:

<code bash>
npm run build:mac
npm run build:win
npm run build:linux
npm run build:rpm
</code>

===== Na co dát pozor =====

  * **Aktivní vývoj** – README výslovně upozorňuje, že projekt je v aktivním vývoji a některé věci se mohou měnit nebo rozbít.
  * **Je to GUI vrstva nad Hermes Agentem** – pro pochopení schopností agenta je pořád důležitý samotný [[ai:platformy:agenti-a-orchestrace:hermes-agent|Hermes Agent]].
  * **Bezpečnost credentials** – při praktickém používání dává smysl řešit secrets provider a neopírat se automaticky jen o plaintext ''.env''.
  * **Desktop buildy nejsou všude podepsané** – Windows a Fedora mají podle README upozornění k podpisům.
  * **Lokální modely musí běžet zvlášť** – lokální provider bez API klíče dává smysl jen tehdy, když už běží kompatibilní server typu Ollama, LM Studio, vLLM nebo llama.cpp.

===== Zdroje =====

  * [[https://github.com/fathah/hermes-desktop|fathah/hermes-desktop – GitHub repozitář]]
  * [[https://raw.githubusercontent.com/fathah/hermes-desktop/main/README.md|Hermes Desktop – README]]
  * [[https://github.com/fathah/hermes-desktop/releases|Hermes Desktop – GitHub Releases]]
  * [[https://hermesagents.cc/|Hermes Desktop – download stránka]]
  * [[https://github.com/NousResearch/hermes-agent|NousResearch/hermes-agent – core Hermes Agent]]

===== Ke stažení =====

  * {{:ai:platformy:agenti-a-orchestrace:hermes-desktop-remote-setup-public-guide.zip?linkonly|Hermes Desktop Remote Setup – Markdown návod v ZIPu}}