hermes-desktop  by fathah

Desktop GUI for advanced AI agent interaction

Created 3 months ago
13,493 stars

Top 3.9% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Hermes Desktop provides a native GUI for the Hermes Agent, a self-improving AI assistant. It simplifies installation, configuration, and daily interaction for users preferring a desktop application over CLI management, offering a unified interface for chat, sessions, profiles, and advanced features.

How It Works

Leveraging Electron, React, and TypeScript, this cross-platform desktop shell manages Hermes Agent installation and LLM provider setup on first launch. Chat requests route through a local API server (http://127.0.0.1:8642), with the app parsing Server-Sent Events (SSE) streams in real-time to render UI elements like tool progress, markdown, and token usage dynamically.

Quick Start & Requirements

Download latest release builds (.dmg for macOS, .AppImage/.deb for Linux). Requires Node.js, npm, and a Unix-like shell for the Hermes installer. macOS users must manually bypass security warnings (xattr -cr "/Applications/Hermes Agent.app" or right-click -> Open) due to lack of code signing. Core agent: https://github.com/NousResearch/hermes-agent.

Highlighted Details

  • Extensive Provider Support: Integrates LLMs from OpenRouter, Anthropic, OpenAI, Google Gemini, Groq, Hugging Face, and local endpoints (Ollama, LM Studio, etc.).
  • Rich Feature Set: Offers 22 slash commands, advanced session management with FTS5 search, multi-provider memory system, persona editing (SOUL.md), and scheduled tasks.
  • Broad Messaging Integration: Supports 16 gateways including Telegram, Discord, Slack, WhatsApp, Signal, Matrix, and email.
  • Tooling: Includes integrations for web search (Exa, Tavily), code execution, file operations, and image generation.

Maintenance & Community

The project is in "active development," with features subject to change and potential breakage. Contributions are welcomed; users should open issues for bugs or feature requests. Core agent functionality resides in the NousResearch/hermes-agent repository.

Licensing & Compatibility

The README does not specify a software license. This omission may hinder adoption, particularly for commercial or closed-source integration.

Limitations & Caveats

Active development implies potential instability and evolving features. macOS users face an initial hurdle due to the lack of code signing. The desktop app is a frontend dependent on the Hermes Agent backend. Licensing details are absent.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
44
Issues (30d)
37
Star History
816 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.