This project provides a native desktop client for the Hermes Agent, enhancing the user experience beyond a web dashboard. It targets Windows and macOS users, offering simplified installation, local runtime management, and a comprehensive UI for interacting with AI agents, thereby lowering the barrier to entry for powerful AI tools.

How It Works

Built with Tauri v2, Rust, React, and TypeScript, Hermes Agent CN Desktop acts as a native shell. It manages the lifecycle of an isolated Hermes Agent core (Hermes-CN-Core), including installation, updates, and health checks. The architecture leverages system WebViews for a small footprint and includes a Rust-based transport bridge to securely proxy REST and SSE requests, bypassing browser CORS limitations for production environments.

Quick Start & Requirements

• Primary install/run: Download pre-built installers from desktop.hermesagent.org.cn or GitHub Releases. For development, clone the repo, run pnpm install, then pnpm web:dev for the frontend and cargo run for the desktop application.
• Prerequisites: Rust stable, Node.js 20+, pnpm 9+, and either Hermes-CN-Core or Hermes CLI installed for local dashboard development. macOS requires Xcode Command Line Tools.
• Links: Official site & downloads: desktop.hermesagent.org.cn. UI prototypes: hermes-cn-ui-prototypes-sans.vercel.app. Community & Docs: Hermes Agent 中文社区.

Highlighted Details

• One-click Installation: Designed for ease of use on Windows and macOS, requiring minimal configuration post-install.
• Lightweight & Cross-Platform: Utilizes system WebViews via Tauri, resulting in small install sizes and support for both major desktop operating systems.
• Integrated Agent Kernel Management: Handles installation, updates, signature verification, health checks, and rollbacks of the local Hermes Agent runtime.
• Comprehensive Agent UI: Features include chat, streaming output, attachments, tool usage, skills, memory management, task scheduling, and runtime diagnostics.
• Production Transport Bridge: A Rust command proxy manages REST, uploads, and SSE, circumventing WebView CORS issues and centralizing authentication.
• YOLO Mode: An optional, high-risk setting that automatically approves dangerous commands after explicit confirmation and kernel restart.

Maintenance & Community

The project is actively maintained by the Hermes Agent Chinese Community. Resources include a community website, detailed Chinese documentation, practice guides, and community channels (e.g., WeChat groups). The project is described as being in "rapid iteration," with potential adjustments to APIs, packaging, and UI details.

Licensing & Compatibility

The software is licensed under the PolyForm Noncommercial License 1.0.0 for non-commercial use. Any commercial use, distribution, integration, or resale requires explicit prior authorization from Qingdao Wanderminds Network Technology Co., Ltd. (lijiale@wanderminds.cn).

Limitations & Caveats

The project is in active development, with APIs, packaging, and runtime distribution strategies subject to change. Commercial use is strictly prohibited without a separate license agreement, making it unsuitable for integration into proprietary commercial products without explicit authorization.