{"repo":"fathah/hermes-desktop","free":true,"listed":false,"github":"https://github.com/fathah/hermes-desktop","clone":"git clone https://github.com/fathah/hermes-desktop.git","description":"Desktop Companion for Hermes Agent","language":"TypeScript","stars":13919,"topics":["ai","ai-agent","autonomous-agents","chatbot","hermes","llm"],"license":"MIT","category":"ai_agent_platform","readme_excerpt":"\"HERMES\n\n
\n

\n \"Twitter\"\n \"Discord\"\n \"License:\n \"Releases\"\n\n \"Stars\"\n\n \n \"Downloads\"\n\n \n \"Downloads\"\n\n \n

\n\n

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

\n\n

\n \n \n \n \n \n \n \n \"Star\n \n \n

\n\n\n> **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](https://github.com/fathah/hermes-desktop/issues). Contributions are welcome!\n\nHermes One is a community maintained native desktop app for installing, configuring, and chatting with [Hermes Agent](https://github.com/NousResearch/hermes-agent) — a self-improving AI assistant with tool use, multi-platform messaging, and a closed learning loop.\n\nInstead 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.\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/D1D41ZEKFO)\n\n## Sponsors\n\n> [Want to appear here?](mailto:fathah@hermesone.org)\n\n
\nClick to collapse\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
\"Atlas 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.
\n\n
\n\n## Install\n\n\"Download\n\n
\nWindows\n
\n\n> **Windows users:** The installer is not code-signed. Windows SmartScreen will warn on first launch — click \"More info\" → \"Run anyway\".\n\n> **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:\n>\n> ```bash\n> echo \"$USER ALL=(ALL) NOPASSWD: ALL\" | sudo tee /etc/sudoers.d/hermes-install\n> # …re-run the installer; once it finishes:\n> sudo rm /etc/sudoers.d/hermes-install\n> ```\n>\n> Tracked in [#109](https://github.com/fathah/hermes-desktop/issues/109).\n\n
\n\n
\nFedora (RPM)\n
\n\n```bash\nsudo dnf install ./hermes-desktop-.rpm\n```\n\n> **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.\n\n
\n\n## Preview\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Chat
\"Chat\"		Profiles
\"Profiles\"
Models
\"Models\"		Providers
\"Providers\"
Tools
\"Tools\"		Discover
\"Skills\"
Schedules
\"Schedules\"		Gateway
\"Gateway\"
Persona
\"Persona\"		Kanban
\"Kanban\"
Office
\"Office\"		Settings
\"Settings\"
\n\n## Features\n\n- **Guided first-run install** for Hermes Agent with progress tracking and dependency resolution\n- **Local or remote backend** — run Hermes locally on `127.0.0.1:8642`, or connect the desktop app to a remote Hermes API server with URL + API key\n- **Multi-provider support** — OpenRouter, Anthropic, OpenAI, Google (Gemini), xAI (Grok), Nous Portal, Qwen, MiniMax, Hugging Face, Groq, and local OpenAI-compatible endpoints (LM Studio, Atomic Chat, Ollama, vLLM, llama.cpp)\n- **Streaming chat UI** with SSE streaming, tool progress indicators, markdown rendering, and syntax highlighting\n- **Token usage tracking** — live prompt/completion token counts and cost display in the chat footer, plus a `/usage` slash command\n- **22 slash commands** — `/new`, `/clear`, `/fast`, `/web`, `/image`, `/browse`, `/code`, `/shell`, `/usage`, `/help`, `/tools`, `/skills`, `/model`, `/memory`, `/persona`, `/version`, `/compact`, `/compress`, `/undo`, `/retry`, `/debug`, `/status`, and more\n- **Session management** — full-text search (SQLite FTS5), date-grouped history, resume and search across conversations\n- **Profile switching** — create, delete, and switch between separate Hermes environments with isolated config\n- **14 toolsets** — web, browser, terminal, file, code execution, vision, image gen, TTS, skills, memory, session search, clarify, delegation, MoA, and task planning\n- **Memory system** — view/edit memory entries, user profile memory, capacity tracking, and discoverable memory providers (Honcho, Hindsight, Mem0, RetainDB, Supermemory, ByteRover)\n- **Persona editor** — edit and reset your agent's SOUL.md personality\n- **Saved models** — CRUD management for model configurations across providers\n- **Scheduled tasks** — cron job builder (minutes, hourly, daily, weekly, custom cron) with 15 delivery targets\n- **16 messaging gateways** — Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email (IMAP/SMTP), SMS (Twilio/Vonage), iMessage (BlueBubbles), DingTalk, Feishu/Lark, WeCom, WeChat (iLink Bot), Webhooks, Home Assistant\n- **Hermes Office (Claw3d)** — visual 3D interface with dev server and adapter management\n- **Backup, import & debug dump** — full data backup/restore and system diagnostics from Settings\n- **Log viewer** — view gateway and agent logs directly from the Settings screen\n- **Auto-updater** — check for and install updates via electron-updater\n- **i18n ready** — internationalization framework with English locale covering all screens, ready for community translations\n- **Test suite** — SSE parser, IPC handlers, preload API surface, installer utilities, and constants validation with Vitest\n\n## How It Works\n\nOn first launch, the app:\n\n1. Asks whether you want to run Hermes **locally** or connect to a **remote** Hermes API server.\n2. **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+).\n3. **Remote mode:** prompts for the remote API URL and API key, validates the connection, and skips local install.\n4. Prompts for an API provider or local model endpoint.\n5. Saves provider config and API keys through Hermes config files.\n6. Launches the main workspace once setup is complete.\n\nIn local mode, chat requests go throu","default_branch":"main","files":1003,"tree":[".agents/skills/electron-pro/SKILL.md",".agents/skills/hermes-agent/SKILL.md",".agents/skills/lat-md/SKILL.md",".agents/skills/typescript-expert/SKILL.md",".agents/skills/typescript-expert/references/tsconfig-strict.json",".agents/skills/typescript-expert/references/typescript-cheatsheet.md",".agents/skills/typescript-expert/references/utility-types.ts",".agents/skills/typescript-expert/scripts/ts_diagnostic.py",".browserslistrc",".claude/settings.json",".claude/skills/electron-pro",".claude/skills/hermes-agent/SKILL.md",".claude/skills/lat-md/SKILL.md",".claude/skills/typescript-expert",".codex/hooks.json",".env.example",".gitattributes",".github/workflows/beta-release.yml",".github/workflows/ci.yml",".github/workflows/release.yml",".gitignore",".husky/pre-commit",".husky/pre-push","AGENTS.md","CLAUDE.md","CONTRIBUTING.ja-JP.md","CONTRIBUTING.md","CONTRIBUTING.zh-CN.md","Development.md","KANBAN_GAP_REPORT.md","LICENSE","PROFILE_MODAL_HANDOFF.md","README.es-LATAM.md","README.ja-JP.md","README.md","README.zh-CN.md","assets/header.webp","assets/partners/atlascloud.webp","assets/partners/greptile.webp","build/afterPack.js","build/entitlements.mac.inherit.plist","build/entitlements.mac.plist","build/icon.icns","build/icon.ico","build/icon.png","build/linux-after-install.sh","build/winget/Installer.template.yaml","build/winget/Locale.en-US.template.yaml","build/winget/Version.template.yaml","changelogs/0.4.5.md","changelogs/0.5.0.md","changelogs/0.6.0.md","changelogs/0.7.0.md","dev-app-update.yml","docs/SSH-TUNNEL-VPS.md","docs/chat-reconciliation-plan.md","docs/reconciliation-regression-playbook.md","docs/remote-access-lab.md","docs/ssh-dashboard-transport.md","docs/superpowers/plans/2026-04-30-windows-winget-fedora-rpm-release.md","docs/superpowers/plans/2026-07-14-remote-dashboard-oauth.md","docs/superpowers/specs/2026-04-30-windows-winget-fedora-rpm-release-design.md","docs/superpowers/specs/2026-07-14-remote-dashboard-oauth-design.md","electron-builder.yml","electron.vite.config.ts","eslint.config.mjs","lat.md/.cache/lat_init.json","lat.md/agent-sync.md","lat.md/analytics.md","lat.md/chat-commands.md","lat.md/chat-experience-preferences.md","lat.md/chat-performance.md","lat.md/code-blocks.md","lat.md/context-folder.md","lat.md/desktop-updates.md","lat.md/hermes-account-login.md","lat.md/kanban.md","lat.md/lat.md","lat.md/loading-indicators.md","lat.md/main-process.md","lat.md/mcp-servers.md","lat.md/model-context.md","lat.md/model-selection.md","lat.md/office-3d-interiors.md","lat.md/office-3d-traffic.md","lat.md/office-3d-walk-mode.md","lat.md/office-interactions.md","lat.md/office-world-actions.md","lat.md/onboarding.md","lat.md/provider-setup.md","lat.md/reasoning-effort.md","lat.md/remote-dashboard-oauth.md","lat.md/sidebar-navigation.md","lat.md/wallet-token-balances.md","lat.md/web-preview.md","lat.md/window-chrome.md","package-lock.json","package.json","pr-comment.md","previews/chat.png","previews/discover.png","previews/download.webp","previews/gateway.png","previews/header.webp","previews/kanban.png","previews/memory.png","previews/models.png","previews/office.png","previews/persona.png","previews/profiles.png","previews/providers.png","previews/schedules.png","previews/sessions.png","previews/settings.png","previews/skills.png","previews/tools.png","resources/icon.png","scripts/README.md","scripts/drive-live-regression-suite.js","scripts/drive-nous-chat.js","scripts/drive-nous-oauth.js","scripts/e2e-attach.js","scripts/generate-winget-manifests.mjs","scripts/hermes-sandbox.ps1","scripts/probe-chat-state.js","scripts/probe-models-list.js","scripts/probe-nous-models.js","scripts/probe-selectors.js","scripts/probe-validation-and-banner.js","scripts/probe-wsl-detection.js","scripts/remote-lab.ps1","scripts/remote-lab/docker-compose.yml","scripts/remote-lab/nginx.conf","scripts/repro-edit-model-emptykey.js","scripts/repro-gateway-restart-midchat.js","scripts/repro-gateway-restart-v2.js","scripts/repro-long-conversation.js","scripts/repro-nous-cards-schema-367.js","scripts/repro-nous-detection-367.js","scripts/repro-session-cont-error.js","scripts/repro-session-proliferation.js","scripts/set-version.mjs","scripts/ssh-lab.ps1","scripts/ssh-lab/Dockerfile","scripts/ssh-lab/docker-compose.yml","scripts/ssh-lab/entrypoint.sh","scripts/verify-369-wsl-drift.js","scripts/verify-compat-host-derived-key.js","scripts/verify-nous-discovery.js","scripts/verify-wsl-detection.js","skills-lock.json","src/main/account-store.test.ts","src/main/account-store.ts","src/main/agent-config-providers.test.ts","src/main/agent-config-providers.ts","src/main/agent-sync.test.ts","src/main/agent-sync.ts","src/main/api-url.ts","src/main/app/context-menu.ts","src/main/app/menu.ts","src/main/app/start.ts","src/main/app/updater.ts","src/main/askpass.ts","src/main/attachment-staging.ts","src/main/auxiliary-config.ts","src/main/claw3d.ts","src/main/config-health.test.ts","src/main/config-health.ts","src/main/config.ts","src/main/cronjobs.ts","src/main/dashboard-launch.ts","src/main/dashboard-websocket-relay.ts","src/main/dashboard.ts","src/main/db.ts","src/main/default-models.ts","src/main/env.d.ts","src/main/gateway-ports.ts","src/main/gatewayPrompt.ts","src/main/gpu-fallback.ts","src/main/hermes-account.test.ts","src/main/hermes-account.ts","src/main/hermes-agent-compat.ts","src/main/hermes-auth.ts","src/main/hermes.test.ts","src/main/hermes.ts","src/main/hermesone-provision.test.ts","src/main/hermesone-provision.ts","src/main/host-derived-env.ts","src/main/index.ts","src/main/installer.ts","src/main/ipc/register.ts","src/main/kanban.ts","src/main/load-env.ts","src/main/locale.ts","src/main/mcp-servers.ts","src/main/media.ts","src/main/memory-limits.ts","src/main/memory.ts","src/main/messaging-platforms.ts","src/main/model-discovery.ts","src/main/models.ts","src/main/office-start.ts","src/main/process-options.ts","src/main/profile-meta.ts","src/main/profiles.ts","src/main/provider-registry.ts","src/main/providers-store.test.ts","src/main/providers-store.ts","src/main/providers.ts","src/main/registry.ts","src/main/remote-api.test.ts","src/main/remote-api.ts","src/main/remote-metadata.ts","src/main/remote-models.ts","src/main/remote-oauth.ts","src/main/remote-provider-statuses.ts","src/main/remote-sessions.ts","src/main/remote-skills.test.ts","src/main/remote-skills.ts","src/main/run-stream.test.ts","src/main/run-stream.ts","src/main/secrets/commandProvider.property.test.ts","src/main/secrets/commandProvider.stdio.test.ts","src/main/secrets/commandProvider.test.ts","src/main/secrets/commandProvider.ts","src/main/secrets/envProvider.ts","src/main/secrets/getSpawnFloor.test.ts","src/main/secrets/index.test.ts","src/main/secrets/index.ts","src/main/secrets/provider.ts","src/main/secrets/resolvedSecretMap.test.ts","src/main/secrets/securityInvariants.test.ts","src/main/secrets/spawnRateFloor.test.ts","src/main/security.ts","src/main/session-attachment-store.ts","src/main/session-cache.ts","src/main/session-context-folder-store.ts","src/main/session-continuation-store.ts","src/main/session-model-override-store.test.ts","src/main/session-model-override-store.ts","src/main/sessions.ts","src/main/skills.ts","src/main/soul.ts","src/main/sse-parser.ts","src/main/ssh-docker.ts","src/main/ssh-options.ts","src/main/ssh-remote.test.ts","src/main/ssh-remote.ts","src/main/ssh-tunnel.ts","src/main/sudoCreds.ts","src/main/terminal-launcher.ts","src/main/tools.ts","src/main/tui-gateway-stream.test.ts","src/main/tui-gateway-stream.ts","src/main/updater-log.ts","src/main/utils.ts","src/main/validation.ts","src/main/wallet-actions.test.ts","src/main/wallet-actions.ts","src/main/wallet-balances.test.ts","src/main/wallet-balances.ts","src/main/wallet-store.test.ts","src/main/wallet-store.ts","src/main/wallet-sync.test.ts","src/main/wallet-sync.ts","src/main/web-preview-inspector.test.ts","src/main/web-preview-inspector.ts","src/main/ws.d.ts","src/main/wsl-detection.ts","src/main/yaml-path.ts","src/preload/askpass.ts","src/preload/index.d.ts","src/preload/index.ts","src/renderer/index.html","src/renderer/src/App.tsx","src/renderer/src/assets/base.css","src/renderer/src/assets/fonts/Cairo-Bold.ttf","src/renderer/src/assets/fonts/Cairo-Medium.ttf","src/renderer/src/assets/fonts/Cairo-Regular.ttf","src/renderer/src/assets/fonts/Cairo-SemiBold.ttf","src/renderer/src/assets/fonts/Manrope-Bold.ttf","src/renderer/src/assets/fonts/Manrope-Medium.ttf","src/renderer/src/assets/fonts/Manrope-Regular.ttf","src/renderer/src/assets/fonts/Manrope-SemiBold.ttf","src/renderer/src/assets/fonts/SpaceGrotesk-Variable.ttf","src/renderer/src/assets/hermes-icon.svg","src/renderer/src/assets/hermes-one.svg","src/renderer/src/assets/hermesbg.webp","src/renderer/src/assets/icon.png","src/renderer/src/assets/icons/etherium.webp","src/renderer/src/assets/icons/hdtoken.webp","src/renderer/src/assets/icons/index.tsx","src/renderer/src/assets/iconv2.png","src/renderer/src/assets/images/one-chat.svg","src/renderer/src/assets/loadingo.gif","src/renderer/src/assets/logos/api.svg","src/renderer/src/assets/logos/atlascloud.svg","src/renderer/src/assets/logos/atomicchat.svg","src/renderer/src/assets/logos/cerebras-color.svg","src/renderer/src/assets/logos/cerebras.svg","src/renderer/src/assets/logos/claude-color.svg","src/renderer/src/assets/logos/deepseek-color.svg","src/renderer/src/assets/logos/dingtalk.svg","src/renderer/src/assets/logos/discord.svg","src/renderer/src/assets/logos/email.svg","src/renderer/src/assets/logos/fireworks-color.svg","src/renderer/src/assets/logos/fireworksai.svg","src/renderer/src/assets/logos/gemini-color.svg","src/renderer/src/assets/logos/grok.svg","src/renderer/src/assets/logos/groq.svg","src/renderer/src/assets/logos/home-assist.svg","src/renderer/src/assets/logos/huggingface.svg","src/renderer/src/assets/logos/imessage.svg","src/renderer/src/assets/logos/lark.svg","src/renderer/src/assets/logos/lmstudio.svg","src/renderer/src/assets/logos/matrix-dark.svg","src/renderer/src/assets/logos/mattermost-dark.svg","src/renderer/src/assets/logos/meta-color.svg","src/renderer/src/assets/logos/mimo.svg","src/renderer/src/assets/logos/minimax-color.svg","src/renderer/src/assets/logos/mistral-color.svg","src/renderer/src/assets/logos/moonshot.svg","src/renderer/src/assets/logos/nousresearch.svg","src/renderer/src/assets/logos/nvidia-color.svg","src/renderer/src/assets/logos/ollama.svg","src/renderer/src/assets/logos/openai.svg","src/renderer/src/assets/logos/opencode.svg","src/renderer/src/assets/logos/openrouter.svg","src/renderer/src/assets/logos/perplexity-color.svg","src/renderer/src/assets/logos/python.svg","src/renderer/src/assets/logos/qqbot.svg","src/renderer/src/assets/logos/qwen.svg","src/renderer/src/assets/logos/signal.svg","src/renderer/src/assets/logos/slack.svg","src/renderer/src/assets/logos/sms.svg","src/renderer/src/assets/logos/telegram.svg","src/renderer/src/assets/logos/together-color.svg","src/renderer/src/assets/logos/togetherai.svg","src/renderer/src/assets/logos/twitter.svg","src/renderer/src/assets/logos/vllm.svg","src/renderer/src/assets/logos/webhook.svg","src/renderer/src/assets/logos/wechat.svg","src/renderer/src/assets/logos/wecom.svg","src/renderer/src/assets/logos/whatsapp-icon.svg","src/renderer/src/assets/logos/yuanbao.svg","src/renderer/src/assets/logos/zai.svg","src/renderer/src/assets/main.css","src/renderer/src/assets/splash.png","src/renderer/src/assets/splashtext-w.webp","src/renderer/src/assets/splashtext.png","src/renderer/src/assets/startvid.mp4","src/renderer/src/assets/title-line.svg","src/renderer/src/components/AgentMarkdown.test.tsx","src/renderer/src/components/AgentMarkdown.tsx","src/renderer/src/components/AttachmentChip.tsx","src/renderer/src/components/AuxiliaryTasksSection.tsx","src/renderer/src/components/ChatPreferencesProvider.test.tsx","src/renderer/src/components/ChatPreferencesProvider.tsx","src/renderer/src/components/ConfigHealthBanner.test.tsx","src/renderer/src/components/ConfigHealthBanner.tsx","src/renderer/src/components/ErrorBoundary.tsx","src/renderer/src/components/FollowUsModal.tsx","src/renderer/src/components/FontProvider.tsx","src/renderer/src/components/HermesAccountModal.tsx","src/renderer/src/components/I18nContext.ts","src/renderer/src/components/I18nProvider.test.tsx","src/renderer/src/components/I18nProvider.tsx","src/renderer/src/components/MediaImage.lightbox.test.tsx","src/renderer/src/components/MediaImage.tsx","src/renderer/src/components/OAuthLoginModal.tsx","src/renderer/src/components/OrbLoader.tsx","src/renderer/src/components/ProviderKeysSection.tsx","src/renderer/src/components/RegistryBrowserModal.tsx","src/renderer/src/components/RemoteNotice.tsx","src/renderer/src/components/ThemeProvider.tsx","src/renderer/src/components/VerifyWarningBanner.tsx","src/renderer/src/components/Versions.tsx","src/renderer/src/components/common/BrandLogo.tsx","src/renderer/src/components/common/HermesLogo.tsx","src/renderer/src/components/common/OnboardHero.tsx","src/renderer/src/components/common/ProfileAvatar.tsx","src/renderer/src/components/modal/AppModal.tsx","src/renderer/src/components/profile/ProfileModal.test.tsx","src/renderer/src/components/profile/ProfileModal.tsx","src/renderer/src/components/profile/ProfileModalContext.ts","src/renderer/src/components/profile/ProfileModalProvider.tsx","src/renderer/src/components/profile/ProfileSyncPane.test.tsx","src/renderer/src/components/profile/ProfileSyncPane.tsx","src/renderer/src/components/profile/ProfileWalletPane.test.tsx","src/renderer/src/components/profile/ProfileWalletPane.tsx","src/renderer/src/components/settings/AboutPane.tsx","src/renderer/src/components/settings/AppearancePane.test.tsx","src/renderer/src/components/settings/AppearancePane.tsx","src/renderer/src/components/settings/CommunityPane.tsx","src/renderer/src/components/settings/ConnectionPane.test.tsx","src/renderer/src/components/settings/ConnectionPane.tsx","src/renderer/src/components/settings/DataPane.tsx","src/renderer/src/components/settings/LanguagePane.tsx","src/renderer/src/components/settings/LogsPane.tsx","src/renderer/src/components/settings/NotificationsPane.tsx"],"storefront":"/r/fathah","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/fathah/hermes-desktop/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}