[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74828":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},74828,"hermes-desktop","fathah\u002Fhermes-desktop","fathah","Desktop Companion for Hermes Agent","https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop",null,"TypeScript",11727,1327,65,230,0,977,2882,5149,2931,44.37,"MIT License",false,"main",true,[],"2026-06-12 02:03:28","\u003Cimg width=\"100%\" alt=\"HERMES DESKTOP\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F80585955-3bae-4aee-af90-a1e61757ccb8\" \u002F>\n\n\u003Cbr\u002F>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge\" alt=\"Documentation\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Fhermes_agent_desktop\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTelegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white\" alt=\"Telegram\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Fblob\u002Fmain\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green?style=for-the-badge\" alt=\"License: MIT\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Freleases\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDownload-Releases-FF6600?style=for-the-badge\" alt=\"Releases\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Fstargazers\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ffathah\u002Fhermes-desktop?style=for-the-badge&color=FFD700&label=Stars\" alt=\"Stars\">\n\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Freleases\u002F\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Ffathah\u002Fhermes-desktop\u002Ftotal?style=for-the-badge&color=00B496&label=Total%20Downloads\" alt=\"Downloads\">\n\u003C\u002Fa>\n\u003C\u002Fp>\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:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Fissues). Contributions are welcome!\n\n## Languages\n\n- English: `README.md`\n- 简体中文: `README.zh-CN.md`\n\nHermes Desktop is a native desktop app for installing, configuring, and chatting with [Hermes Agent](https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-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 `~\u002F.hermes`, and gives you a GUI for chat, sessions, profiles, memory, skills, tools, scheduling, messaging gateways, and more.\n\n## Install\n\nDownload the latest build from the [Releases](https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Freleases\u002F) page.\n\n| Platform       | File                    |\n| -------------- | ----------------------- |\n| macOS          | `.dmg`                  |\n| Linux (any)    | `.AppImage`             |\n| Linux (Debian) | `.deb`                  |\n| Linux (Fedora) | `.rpm`                  |\n| Windows        | `.exe` (NSIS installer) |\n\n### Windows (winget)\n\nOnce the manifest has been accepted into [`microsoft\u002Fwinget-pkgs`](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fwinget-pkgs), you can install with:\n\n```powershell\nwinget install NousResearch.HermesDesktop\n```\n\nUntil then, download the `.exe` from the Releases page.\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 \u002Fetc\u002Fsudoers.d\u002Fhermes-install\n> # …re-run the installer; once it finishes:\n> sudo rm \u002Fetc\u002Fsudoers.d\u002Fhermes-install\n> ```\n>\n> Tracked in [#109](https:\u002F\u002Fgithub.com\u002Ffathah\u002Fhermes-desktop\u002Fissues\u002F109).\n\n### Fedora (RPM)\n\n```bash\nsudo dnf install .\u002Fhermes-desktop-\u003Cversion>.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## Preview\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\">\u003Cb>Office\u003C\u002Fb>\u003Cbr\u002F>\u003Cimg width=\"100%\" alt=\"Office\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F214bfa60-48ec-4449-be40-370628205147\" \u002F>\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\">\u003Cb>Chat\u003C\u002Fb>\u003Cbr\u002F>\u003Cimg width=\"100%\" alt=\"Chat\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fca84a56c-4d14-4775-96bb-c725069988be\" \u002F>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\">\u003Cb>Profiles\u003C\u002Fb>\u003Cbr\u002F>\u003Cimg width=\"100%\" alt=\"Profiles\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fbd812e4a-bbdc-4141-b3a8-1ab5b0e561d4\" \u002F>\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\">\u003Cb>Tools\u003C\u002Fb>\u003Cbr\u002F>\u003Cimg width=\"100%\" alt=\"Tools\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fad051fbe-055d-40d2-b6dd-959c522412d2\" \u002F>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\">\u003Cb>Settings\u003C\u002Fb>\u003Cbr\u002F>\u003Cimg width=\"100%\" alt=\"Settings\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb3f7e0d8-b087-4935-b57c-f8db30491f2e\" \u002F>\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\">\u003Cb>Skills\u003C\u002Fb>\u003Cbr\u002F>\u003Cimg width=\"100%\" alt=\"Skills\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F508c3501-52eb-419d-8cfd-06268875ff62\" \u002F>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\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, 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\u002Fcompletion token counts and cost display in the chat footer, plus a `\u002Fusage` slash command\n- **22 slash commands** — `\u002Fnew`, `\u002Fclear`, `\u002Ffast`, `\u002Fweb`, `\u002Fimage`, `\u002Fbrowse`, `\u002Fcode`, `\u002Fshell`, `\u002Fusage`, `\u002Fhelp`, `\u002Ftools`, `\u002Fskills`, `\u002Fmodel`, `\u002Fmemory`, `\u002Fpersona`, `\u002Fversion`, `\u002Fcompact`, `\u002Fcompress`, `\u002Fundo`, `\u002Fretry`, `\u002Fdebug`, `\u002Fstatus`, 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\u002Fedit 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\u002FSMTP), SMS (Twilio\u002FVonage), iMessage (BlueBubbles), DingTalk, Feishu\u002FLark, 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\u002Frestore 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\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 `~\u002F.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 through `http:\u002F\u002F127.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.\n\n## Screens\n\n| Screen        | Description                                                                           |\n| ------------- | ------------------------------------------------------------------------------------- |\n| **Chat**      | Streaming conversation UI with slash commands, tool progress, and token tracking      |\n| **Sessions**  | Browse, search, and resume past conversations                                         |\n| **Agents**    | Create, delete, and switch between Hermes profiles                                    |\n| **Skills**    | Browse, install, and manage bundled and installed skills                              |\n| **Models**    | Manage saved model configurations per provider                                        |\n| **Memory**    | View\u002Fedit memory entries, user profile, and configure memory providers                |\n| **Soul**      | Edit the active profile's persona (SOUL.md)                                           |\n| **Tools**     | Enable or disable individual toolsets                                                 |\n| **Schedules** | Create and manage cron jobs with delivery targets                                     |\n| **Gateway**   | Configure and control messaging platform integrations                                 |\n| **Office**    | Claw3d visual interface setup and management                                          |\n| **Settings**  | Provider config, credential pools, backup\u002Fimport, log viewer, network settings, theme |\n\n## Supported Providers\n\n### LLM Providers\n\n| Provider            | Notes                                    |\n| ------------------- | ---------------------------------------- |\n| **OpenRouter**      | 200+ models via single API (recommended) |\n| **Anthropic**       | Direct Claude access                     |\n| **OpenAI**          | Direct GPT access                        |\n| **Google (Gemini)** | Google AI Studio                         |\n| **xAI (Grok)**      | Grok models                              |\n| **Nous Portal**     | Free tier available                      |\n| **Qwen**            | QwenAI models                            |\n| **MiniMax**         | Global and China endpoints               |\n| **Hugging Face**    | 20+ open models via HF Inference         |\n| **Groq**            | Fast inference (voice\u002FSTT)               |\n| **Local\u002FCustom**    | Any OpenAI-compatible endpoint           |\n\nLocal presets are included for LM Studio, Ollama, vLLM, and llama.cpp.\n\n### Messaging Platforms\n\nTelegram, Discord, Slack, WhatsApp, Signal, Matrix\u002FElement, Mattermost, Email (IMAP\u002FSMTP), SMS (Twilio & Vonage), iMessage (BlueBubbles), DingTalk, Feishu\u002FLark, WeCom, WeChat (iLink Bot), Webhooks, and Home Assistant.\n\n### Tool Integrations\n\nExa Search, Parallel API, Tavily, Firecrawl, FAL.ai (image generation), Honcho, Browserbase, Weights & Biases, and Tinker.\n\n## Development\n\n### Prerequisites\n\n- Node.js and npm\n- A Unix-like shell environment for the Hermes installer\n- Network access for downloading Hermes during first-run install\n\n### Install dependencies\n\n```bash\nnpm install\n```\n\n### Start the app in development\n\n```bash\nnpm run dev\n```\n\n### Run checks\n\n```bash\nnpm run lint\nnpm run typecheck\n```\n\n### Run tests\n\n```bash\nnpm run test\nnpm run test:watch\n```\n\n### Build the desktop app\n\n```bash\nnpm run build\n```\n\nPlatform packaging:\n\n```bash\nnpm run build:mac\nnpm run build:win\nnpm run build:linux\nnpm run build:rpm    # Fedora\u002FRHEL .rpm only\n```\n\n## First-Time Setup\n\nWhen the app opens for the first time, it will either detect an existing Hermes installation or offer to install it for you.\n\nSupported setup paths in the UI:\n\n- `OpenRouter`\n- `Anthropic`\n- `OpenAI`\n- `Local LLM` via an OpenAI-compatible base URL\n\nLocal presets are included for:\n\n- LM Studio\n- Ollama\n- vLLM\n- llama.cpp\n\nHermes files are managed in:\n\n- `~\u002F.hermes`\n- `~\u002F.hermes\u002F.env`\n- `~\u002F.hermes\u002Fconfig.yaml`\n- `~\u002F.hermes\u002Fhermes-agent`\n- `~\u002F.hermes\u002Fprofiles\u002F` — named profile directories\n- `~\u002F.hermes\u002Fstate.db` — session history database\n- `~\u002F.hermes\u002Fcron\u002Fjobs.json` — scheduled tasks\n\n## Tech Stack\n\n- **Electron** 39 — cross-platform desktop shell\n- **React** 19 — UI framework\n- **TypeScript** 5.9 — type safety across main and renderer processes\n- **Tailwind CSS** 4 — utility-first styling\n- **Vite** 7 + electron-vite — fast dev server and build tooling\n- **better-sqlite3** — local session storage with FTS5 full-text search\n- **i18next** — internationalization framework\n- **Vitest** — test runner\n\n## Notes\n\n- The desktop app depends on the upstream Hermes Agent project for agent behavior and tool execution.\n- The built-in installer runs the official Hermes install script with `--skip-setup`, then completes provider configuration in the GUI.\n- Local model providers do not require an API key, but the compatible server must already be running.\n- Alternative npm registry routes are supported for environments with restricted network access.\n\n## Contributing\n\nContributions are welcome! Check out the [Contributing Guide](CONTRIBUTING.md) to get started. If you're not sure where to begin, take a look at the [open issues](https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-desktop\u002Fissues). Found a bug or have a feature request? [File an issue](https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-desktop\u002Fissues\u002Fnew).\n\n## Related Project\n\nFor the core agent, docs, and CLI workflows, see the main Hermes Agent repository:\n\n- https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-agent\n","Hermes Desktop 是一个用于安装、配置和与 Hermes Agent 交互的原生桌面应用程序。它支持通过图形界面进行聊天、会话管理、个人资料设置、记忆管理、技能工具使用、日程安排及多平台消息传递等功能，简化了原本需要在命令行下手动操作的过程。项目采用 TypeScript 编写，确保了跨平台兼容性的同时也提供了良好的开发体验。适用于希望更直观地管理和使用 Hermes Agent 的用户，无论是技术爱好者还是寻求高效人机交互解决方案的专业人士，都能从中受益。",2,"2026-06-11 03:51:01","high_star"]