hermes-desktop  by fathah

Desktop GUI for advanced AI agent interaction

Created 3 weeks ago

New!

426 stars

Top 69.1% 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

23 hours ago

Responsiveness

Inactive

Pull Requests (30d)
12
Issues (30d)
13
Star History
434 stars in the last 25 days

Explore Similar Projects

Starred by Sebastian Raschka Sebastian Raschka(Author of "Build a Large Language Model (From Scratch)"), Pawel Garbacki Pawel Garbacki(Cofounder of Fireworks AI), and
16 more.

chainlit by Chainlit

0.4%
12k
Framework for rapid conversational AI app development
Created 3 years ago
Updated 4 days ago
Feedback? Help us improve.